Ошибки, лимиты и пагинация

Ошибки

Ошибки возвращаются со стандартным HTTP-статусом и телом JSON с полем detail, содержащим машиночитаемый код:

{ "detail": "conversation_not_found" }

Частые коды

• 401 — отсутствует, неверный или отозванный API-ключ.
• 403 developer_api_not_available — тариф проекта не включает API.
• 404 conversation_not_found / contact_not_found.
• 400 conversation_closed, content_required, group_conversations_not_supported, invalid_priority, use_assignment_to_reach_processing, escalation_reason_required, invalid_cursor, invalid_updated_since.
• 429 rate_limited — снизьте частоту (см. ниже).

Лимиты запросов

Лимиты действуют на API-ключ. Превышение возвращает 429 с rate_limited.

• Чтение (список/получение) — 120 запросов/минуту.
• Отправка сообщения — 60 запросов/минуту.
• Обновление диалога — 60 запросов/минуту.
• Управление вебхуками (создание/изменение/удаление) — 30 запросов/минуту.

Пагинация

Списочные эндпоинты используют курсорную пагинацию. Страница выглядит так:

{
  "results": [ /* ... */ ],
  "next_cursor": "MjAyNi0wNy0wMVQ...",
  "has_more": true
}

• Передавайте limit для размера страницы (по умолчанию 50, максимум 100).
• Когда has_more равно true, передайте полученный next_cursor в параметре cursor, чтобы получить следующую страницу.
• Останавливайтесь, когда has_more равно false (next_cursor — null).
• Некорректный курсор возвращает 400 invalid_cursor.

curl "https://chatonio.com/api/v1/conversations/?limit=100&cursor=MjAyNi0wNy..." \
  -H "Authorization: Bearer csk_live_your_key_here"