Ошибки и повторные запросы
Как избежать повторной проверки и обработать временный сбой.
Эта страница описывает проверку чеков /v1/checks. Для отдельного анализа PDF действуют свои лимиты и правила повторов.
Повтор запроса без новой проверки
Для каждой попытки проверки создайте Idempotency-Key — строку до 128 символов.
Если ответ потерялся, повторите запрос с тем же ключом, файлом, именем файла и параметрами.
В течение 24 часов вы получите сохранённый результат без повторного расходования лимита.
Для другой попытки или изменённых данных используйте новый ключ.
Тот же ключ с другим содержимым вернёт 409 idempotency_conflict.
Ошибка HTTP
При отклонении запроса API возвращает соответствующий HTTP-статус и тело:
{
"error": {
"code": "validation",
"message": "Некорректные expectation или tags",
"details": {}
}
}| HTTP | Код | Что делать |
|---|---|---|
| 401 | unauthorized | Проверить API-ключ |
| 403 | tenant_disabled, profile_forbidden | Уточнить доступ у поддержки |
| 404 | not_found | Проверить ID проверки и используемый ключ |
| 409 | processing | Подождать Retry-After и повторить запрос |
| 409 | idempotency_conflict | Для изменённого запроса использовать новый ключ |
| 413 | upload_too_large | Отправить файл допустимого размера |
| 422 | validation, unknown_profile, identifier_required | Исправить параметры запроса |
| 429 | rate_limit, quota_exceeded | Подождать время из Retry-After; при необходимости обратиться в поддержку |
| 503 | overloaded, database_unavailable | Повторить запрос позже с тем же ключом идемпотентности |
Retry-After задаётся в секундах. Если заголовка нет, увеличивайте паузу между
повторами; не отправляйте их непрерывно.
HTTP 200, но проверка не завершилась
Ответ status: failed означает ошибку обработки. Сохраните id и прочитайте error.
Если error.retryable: true, можно повторить обработку с новым Idempotency-Key:
старый ключ вернёт сохранённую ошибку. Если повтор не помог, передайте ID проверки
поддержке.
status: done с recommendation: reject — завершённая проверка, а не техническая
ошибка. Автоматически отправлять тот же документ заново не нужно.
Размер, время и лимиты
- Стандартный максимальный размер файла — 15 МБ.
- Обработка занимает до 45 секунд плюс передача файла; установите таймаут клиента с запасом.
- Стандартное ограничение — 120 новых проверок в минуту. Условия вашей компании могут отличаться.
- Завершённая проверка расходует одну единицу лимита независимо от рекомендации.
Ошибка обработки с
status: failedлимит не расходует. - Чтение результатов и отправка отзыва не создают новую проверку.
Остаток лимита и время его обновления доступны в личном кабинете.