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 |
Если сообщение — access denied
Заголовок раздела «Если сообщение — access denied»Порядок разбора:
Шаг 1. Маршрут существует. Путь и глагол сверяются со справочником.
Шаг 2. Маршрут входит в список ключа — что может ключ интеграции.
Шаг 3. Маршрута в списке нет — доступ запрашивается отдельно с указанием маршрута, HTTP-метода и назначения.
Шаг 4. Маршрут в списке есть, 403 остался. Проверяется: компания не заблокирована,
ключ активирован, запрос идёт тем же ключом.
Шаг 5. Ответ 200, данные неполные — права роли ключа:
что меняют переключатели доступов.
| Причина | Как выглядит | Что делать |
|---|---|---|
| Перепутан HTTP-метод | путь верный, глагол нет | сверить глагол со справочником |
| Опечатка в пути | лишний /api, склеенный URL, пропущенный слэш |
сверить путь |
| Метода не существует | путь взят из старой документации | найти актуальный аналог |
Дополнительные материалы
Заголовок раздела «Дополнительные материалы»- Что может ключ интеграции — полный список доступных маршрутов
- Права роли ключа — что меняют переключатели доступов внутри разрешённых методов
- Аутентификация и права — как устроена модель доступа