Tallker
Tallker API v1

Ошибки

Единый формат ошибок, коды HTTP и безопасная стратегия повторных запросов.

Перейти к инструкции →
Пример интеграции
HTTP/1.1 409 Conflict
Content-Type: application/problem+json

{"error":"Idempotency-Key was already used for another request"}

Как это работает

  1. 1Сначала проверяйте HTTP-статус, затем поле error.
  2. 2Повторяйте только временные ошибки 429 и 5xx.
  3. 3Для заказов сохраняйте исходный Idempotency-Key при повторе того же запроса.

Примеры

HTTP/1.1 409 Conflict
Content-Type: application/problem+json

{"error":"Idempotency-Key was already used for another request"}

Параметры и требования

ПараметрТребованиеОписание
400исправить запросНевалидное тело или обязательное поле
401проверить ключНет ключа, неверный ключ или scope
404проверить IDРесурс не найден
409не повторять с новым теломКонфликт идемпотентности
429повторить позжеПревышен лимит; учитывайте Retry-After
5xxповторить с backoffВременная серверная ошибка

Результат

{"error":"описание ошибки"}

Лимиты и идемпотентность

120 requests / minute · HTTP 429 · Retry-After · Idempotency-Key 24h

Безопасность

Используйте exponential backoff с jitter.

Не записывайте API-ключи и персональные данные в открытые логи.

OpenAPI 3.1