Ошибки API: HTTP-коды

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

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

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

Полный справочник кодов

Описание и решения

400 Bad Request

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

Решения:

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

401 Unauthorized

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

Решения:

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

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

403 Forbidden

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

Решения:

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

404 Not Found

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

Решения:

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

409 Conflict

Что значит: конфликт данных. Например, дублирование.

Решения:

1. Проверьте, не создан ли уже такой ресурс.
2. Используйте уникальные идентификаторы.

422 Unprocessable Entity

Что значит: данные не прошли валидацию.

Решения:

1. Проверьте формат email.
2. Проверьте формат телефона.
3. Проверьте длину полей.

429 Too Many Requests

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

Решения:

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

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

500 Internal Server Error

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

Решения:

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

502 Bad Gateway

Что значит: ошибка шлюза между сервисами.

Решения:

1. Повторите запрос.
2. Если повторяется — обратитесь в поддержку.

503 Service Unavailable

Что значит: сервис временно недоступен.

Решения:

1. Подождите 1–2 минуты.
2. Повторите запрос.
3. Проверьте статус сервиса в поддержке.

Как узнать requestId

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

См. также

• Обработка ошибок API
• Ошибка 401 и 403
• Ошибка 429

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

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