Перейти к содержимому

403 и 404

403 → токен принят, маршрут запрещён → раздел «403»
404 → маршрут не найден или метод не тот → раздел «404»
401 → токен истёк или ключ отключён → /concepts/auth/

Тело ответа выглядит так:

{ "code": 403, "message": "forbidden", "error": "access denied", "data": null }

Причина различается по полю error:

error в теле Что это Что делать
access denied маршрут не входит в список, разрешённый ключу см. ниже
company is blocked заблокирована компания обращение к менеджеру BILLZ

Порядок разбора:

Шаг 1. Маршрут существует. Путь и глагол сверяются со справочником.

Шаг 2. Маршрут входит в список ключа — что может ключ интеграции.

Шаг 3. Маршрута в списке нет — доступ запрашивается отдельно с указанием маршрута, HTTP-метода и назначения.

Шаг 4. Маршрут в списке есть, 403 остался. Проверяется: компания не заблокирована, ключ активирован, запрос идёт тем же ключом.

Шаг 5. Ответ 200, данные неполные — права роли ключа: что меняют переключатели доступов.

Причина Как выглядит Что делать
Перепутан HTTP-метод путь верный, глагол нет сверить глагол со справочником
Опечатка в пути лишний /api, склеенный URL, пропущенный слэш сверить путь
Метода не существует путь взят из старой документации найти актуальный аналог