CheckcraftОшибки 401, 403, 405 и 415 в Postman: что значат и как исправить
Checkcraft — программа для проверки API и логов без кода, есть бесплатная версия. Скачать без регистрации →
Запрос из Postman возвращает ошибку 4xx, а из документации всё вроде бы правильно. У каждого кода своя типичная причина, и обычно она видна на одной из вкладок запроса.
401 Unauthorized: сервер не узнал вас
Токена нет, он неверный или истёк. Откройте вкладку Authorization: выбран ли нужный тип и не стоит ли No Auth. Если токен подставляется переменной вида {{token}}, проверьте, выбрано ли окружение и есть ли в нём значение: Postman подсвечивает неизвестную переменную. Для Bearer важно слово Bearer перед токеном. Срок токена видно в его расшифровке.
403 Forbidden: узнал, но не пускает
Сервер понял, кто вы, но у этого пользователя или токена нет прав на операцию: не та роль, не тот scope, запрет по IP или чужой ресурс. Повторите запрос под пользователем с нужными правами. Если 403 приходит и на заведомо разрешённое действие, проверьте, для какого окружения выпущен токен.
405 Method Not Allowed: не тот метод для этого адреса
По этому адресу нет такого метода: например, POST отправлен на адрес конкретного объекта или GET на адрес, который принимает только POST. Сверьте метод и путь с документацией, включая косую черту в конце. Сервер часто перечисляет разрешённые методы в заголовке ответа Allow.
415 Unsupported Media Type: сервер не понял формат тела
Тело отправлено не в том формате, который ждёт сервер. На вкладке Body для JSON выберите raw и тип JSON: тогда Postman сам поставит Content-Type: application/json. Если сервер ждёт form-data или x-www-form-urlencoded, выберите их. Проверьте вкладку Headers, включая скрытые автоматические заголовки: вручную заданный Content-Type мог перебить правильный.
Как не ловить это заново после каждого релиза
Сохраните запросы с ожидаемыми кодами: правильный запрос должен давать 200, без токена 401, с чужим ресурсом 403. В Checkcraft такие проверки сохраняются правилами на код ответа и запускаются набором.
Повторите это на своём API
Checkcraft — настольная программа: сохраняет проверки ответа API без кода и показывает, что не совпало. Начните с учебного примера, затем подставьте свои обезличенные данные. Free работает на Windows и Linux без ограничения срока.
Скачать FreeКак получить и запустить приложениеСкачивание без регистрации и почты, архив готов за пару минут. Состав бесплатной версии опубликован на странице тарифов.
Документация
Начните с примера по ссылкам и сопоставьте результат с требованием своей проверки.