Sohbetleri listele
GET https://app.apsilo.com/api/public/v1/conversationsSon etkinliğe göre yeniden eskiye sıralı.
Gerekli kapsam: conversations:read
Parametreler
| Parametre | Yer | Tip | Gereklilik | Açıklama |
|---|---|---|---|---|
channel | sorgu | whatsapp · instagram · messenger · x · tiktok · telegram · sikayetvar · email | isteğe bağlı | Kanal |
status | sorgu | open · closed | isteğe bağlı | Durum |
kind | sorgu | dm · comments · mentions · complaint | isteğe bağlı | Sohbet türü |
assignedUserId | sorgu | string (uuid) | nesne | isteğe bağlı | Atanan kullanıcı kimliği veya unassigned |
contactId | sorgu | string (uuid) | isteğe bağlı | Kişi |
updatedSince | sorgu | string (date-time) | isteğe bağlı | Bu andan sonra güncellenenler (ISO 8601) |
limit | sorgu | integer | isteğe bağlı | Sayfa boyutu |
cursor | sorgu | string | isteğe bağlı | Önceki yanıtın nextCursor değeri (opak) |
X-Request-Id | başlık | string | isteğe bağlı | İsteğe bağlı istek kimliğiniz (8–100 karakter: harf, rakam, ._:-); yanıtta aynen döner ve kayıtlara işlenir. |
Yanıtlar
| Durum | Açıklama |
|---|---|
200 | Sohbet listesi |
401 | Kimlik doğrulanamadı. Olası kodlar: API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED. |
403 | Erişim reddedildi. Olası kodlar: FEATURE_NOT_LICENSED, API_SCOPE_MISSING, IP_NOT_ALLOWED, LICENSE_EXPIRED, LICENSE_NOT_FOUND, FORBIDDEN. |
422 | İşlenemeyen istek. Olası kodlar: VALIDATION_FAILED, MESSAGING_WINDOW_CLOSED, CHANNEL_ACCOUNT_MISSING, CONTACT_BLOCKED, STORAGE_LIMIT_REACHED, SOCIAL_POST_INVALID, SOCIAL_PLATFORM_UNAVAILABLE. |
429 | Hız sınırı aşıldı. Olası kodlar: RATE_LIMITED. |
500 | Sunucu hatası. Olası kodlar: INTERNAL. |
Yanıt gövdesi
| Alan | Tip | Gereklilik | Açıklama |
|---|---|---|---|
data | Conversation[] | zorunlu | |
nextCursor | string,null | zorunlu | Sonraki sayfa için cursor değeri; son sayfada null. |