Ошибки API Didit: коды статуса, тело ответа и решения

​

Коды состояния

​

Тела ошибок

const raw = await response.text();
let body = {};
try {
  body = JSON.parse(raw);
} catch {
  // A 5xx response may not be JSON: rely on response.status.
}
const code = body.code ?? null;
const message = body.detail ?? body.error ?? (Array.isArray(body) ? body[0] : raw);

​

Ошибки API-ключа

​

Недостаточно кредитов

​

Коды ошибок

​

Доступ и биллинг

​

Запросы и идемпотентность

​

Проверки банка, телефона и рисков

​

Верификация бизнеса (KYB)

​

Кошельки цифровой идентификации

​

Отчёты и кейсы

​

Электронная подпись

​

Webhook

​

Повторные попытки и идемпотентность

• 429: дождитесь заголовка Retry-After, затем повторите запрос.
• 502 и 503: повторяйте с задержкой, если в справочнике эндпоинта указано, что списания не было, как это указано для проверок телефона, электронной почты, банковских данных и рисков.
• 502 на POST /v3/database-validation/: сначала прочитайте каждый элемент validation_errors, поскольку один только этот статус не означает временного сбоя.
• 503 при удалении: повторяйте тот же запрос, пока он не вернёт 200.
• Другие 4xx: сначала исправьте запрос, поскольку тот же запрос завершится с той же ошибкой.

​

Связанные материалы

• Ограничение частоты запросов: лимиты, заголовки и тело ответа 429.
• Аутентификация API: как передавать ваш ключ.
• Тестирование в песочнице: воспроизведение результатов без реальных данных и списаний.
• Webhook: доставка, повторные попытки и порядок.