Обработка ошибок API

Коротко: API возвращает HTTP-коды. Каждый код показывает, что произошло. В ответе всегда есть поле error и data с деталями.

Кому подходит

• Роль: Разработчик
• Уровень: Опытный

Коды ответов

Формат ответа с ошибкой

Поля в ответе:

• error — true
• data.message — текст ошибки
• data.requestId — ID запроса для поддержки

Что делать при разных ошибках

400 Bad Request

Причина: неверные параметры запроса.

Решение:

1. Проверьте формат JSON.
2. Проверьте обязательные поля.
3. Проверьте типы значений.

401 Unauthorized

Причина: неверный или отсутствующий API-ключ.

Решение:

1. Проверьте, что X-API-Key передан.
2. Проверьте, что ключ активен.
3. Создайте новый ключ, если старый удалён.

Подробнее: Ошибка 401.

403 Forbidden

Причина: у ключа нет нужного права.

Решение:

1. Откройте настройки ключа.
2. Добавьте нужный scope.
3. Сохраните.

404 Not Found

Причина: неверный URL или несуществующий ID.

Решение:

1. Проверьте базовый URL.
2. Проверьте ID ресурса.
3. Проверьте метод (GET или POST).

429 Too Many Requests

Причина: превышен лимит запросов.

Решение:

1. Уменьшите частоту.
2. Используйте очереди.
3. Обратитесь в поддержку, если лимит критично низкий.

Подробнее: Ошибка 429.

500 Internal Server Error

Причина: ошибка на стороне сервера.

Решение:

1. Повторите запрос через 30 секунд.
2. Если повторяется — обратитесь в поддержку.
3. Укажите requestId в обращении.

Как узнать requestId

В ответе с ошибкой всегда есть поле data.requestId. Сохраняйте его — это поможет поддержке быстрее найти проблему.

См. также

• Базовые URL
• HTTP-коды ошибок
• Ошибка 401 и 403
• Ошибка 429

Нужна помощь?

• OTP-коды: support@otpcod.ru
• Multi API: support@multiapi.ru
• Мой диалог: support@mydialogi.ru