پرش به مطلب اصلی

لیست گفت‌وگوها

لیست گفت‌وگوها

این سرویس برای دریافت لیست تمام گفت‌وگوهای یک کاربر استفاده می‌شود. پارامتر user الزامی است و باید شناسه کاربری (username یا uuid) را مشخص کند. می‌توانید گفت‌وگوها را بر اساس شناسه یک دستیار (Agent) فیلتر کرده و با پارامترهای limit و offset صفحه‌بندی انجام دهید.

مسیر سرویس

GET /api/v1/core/conversations-list/

پارامترهای مسیر (Query Parameters)

نامنوعمکاناجباریتوضیح
userرشتهqueryبلهشناسه یا نام کاربری کاربر
agentرشتهqueryخیرفیلتر کردن گفت‌وگوها بر اساس شناسه دستیار
limitعدد صحیحqueryخیرتعداد نتایج در هر صفحه
offsetعدد صحیحqueryخیرایندکس شروع برای نتایج

هدرها (Headers)

هدرمقدارتوضیح
AuthorizationToken api-tokenتوکن احراز هویت

نمونه فراخوانی

curl --location 'https://app.houshyar24.ir/api/v1/core/conversations-list?user=ali&limit=10&agent=1' \
--header 'Authorization: Token <your-token>'

پاسخ موفق (200)

{
"count": 3,
"next": "https://app.houshyar24.ir/api/v1/core/conversations-list/?user=ali&agent=1&limit=1&offset=1",
"previous": null,
"results": [
{
"conversation_id": "ab798ead-6054-4a69-89d4-5f1956f27d52",
"agent_id": 1,
"is_deleted": false,
"name": "سوال در مورد رنگ ها",
"inputs": {},
"created_at": "2026-06-05T19:56:10.502284+03:30"
}
]
}