API Reference
Пагинация и ошибки
Общий формат списков, nextToken и обработка неуспешных ответов.
Пагинация
Списковые операции используют pageSize и nextToken.
curl "https://botruntime.ru/v1/chat/conversations?pageSize=20" \
-H "Authorization: Bearer $BOT_TOKEN" \
-H "x-bot-id: $BOT_ID"Если ответ содержит meta.nextToken, передайте его в следующий запрос. Не
разбирайте токен и не сохраняйте его как постоянный идентификатор.
{
"conversations": [],
"meta": {
"nextToken": "opaque-value"
}
}Ошибки
Проверяйте HTTP-статус до чтения успешного ответа.
| Статус | Значение |
|---|---|
400 | Запрос не прошёл валидацию. |
401 | Нет действительного токена. |
403 | Недостаточно прав для ресурса. |
404 | Ресурс не найден в доступной области. |
409 | Запрос конфликтует с текущим состоянием. |
429 | Превышен лимит запросов или квота. |
5xx | Платформа не смогла обработать корректный запрос. |
Для 429 и временных 5xx используйте ограниченный exponential backoff с
jitter. Не повторяйте автоматически неидемпотентную операцию, если не знаете,
был ли применён первый запрос.