لیست گفتوگوها
لیست گفتوگوها
این سرویس برای دریافت لیست تمام گفتوگوهای یک کاربر استفاده میشود. پارامتر user
الزامی است و باید شناسه کاربری (username یا uuid) را مشخص کند. میتوانید گفتوگوها را بر اساس شناسه یک دستیار (Agent) فیلتر کرده و با پارامترهای limit
و offset
صفحهبندی انجام دهید.
مسیر سرویس
GET /api/v1/core/conversations-list/
پارامترهای مسیر (Query Parameters)
نام | نوع | مکان | اجباری | توضیح |
---|---|---|---|---|
user | رشته | query | بله | شناسه یا نام کاربری کاربر |
agent | رشته | query | خیر | فیلتر کردن گفتوگوها بر اساس شناسه دستیار |
limit | عدد صحیح | query | خیر | تعداد نتایج در هر صفحه |
offset | عدد صحیح | query | خیر | ایندکس شروع برای نتایج |
هدرها (Headers)
هدر | مقدار | توضیح |
---|---|---|
Authorization | Token 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"
}
]
}