К содержанию
CheckcraftСкачать
Практический сценарий

Ошибка 401 Unauthorized в API и Postman: почему нет доступа

Код 401 означает, что сервер вас не узнал: учётных данных нет, они неверны или истекли. Обычно дело в заголовке Authorization или в самом токене.

Checkcraft ·

Поможем с первой проверкой →

401 и 403: в чём разница

401 Unauthorized: сервер не знает, кто вы, и просит войти. Вместе с ним сервер должен прислать заголовок WWW-Authenticate со схемой входа, например Bearer. 403 Forbidden: сервер вас узнал, но этому пользователю действие запрещено. При 401 нужен другой или свежий токен, при 403 — другие права.

Частые причины

Заголовок не отправлен: в Postman у запроса стоит No Auth вместо Inherit auth from parent, и авторизация коллекции не применяется. Ошибка в формате: нужен Authorization: Bearer и пробел перед токеном. Токен истёк: расшифруйте его и посмотрите поле exp. Токен из другого окружения: выдан тестовым стендом, а запрос идёт на рабочий. Запрос перенаправлен на другой домен: клиенты не пересылают Authorization при таком перенаправлении, и сервер получает запрос без него.

curl -i https://api.example.com/me \
  -H "Authorization: Bearer $TOKEN"

unexpected status 401 Unauthorized

Так пишут утилиты, когда сервер отказал во входе, например Docker при работе с реестром образов. Смысл тот же: учётные данные не приняты. Войдите заново и проверьте, к какому адресу обращается утилита и с какими данными.

Токен в цепочке запросов

Чтобы не копировать токен руками, первый запрос получает его, а следующие подставляют. В Checkcraft значение из ответа сохраняется в переменную и подставляется в заголовок следующего шага без скриптов, а проверка кода ответа сразу покажет, на каком шаге пришёл 401.

Следующий шаг

Повторите это на своём API

Checkcraft — настольная программа: сохраняет проверки ответа API без кода и показывает, что не совпало. Начните с учебного примера, затем подставьте свои обезличенные данные. Free работает на Windows и Linux без ограничения срока.

Скачать FreeКак получить и запустить приложение

Скачивание без регистрации и почты, архив готов за пару минут. Состав бесплатной версии опубликован на странице тарифов.

Документация

MDN: 401 Unauthorized · RFC 9110: коды 4xx

Начните с примера по ссылкам и сопоставьте результат с требованием своей проверки.

Можно спросить человека

Поможем с первой проверкой

Расскажите, что хотите проверить или на каком шаге остановились. Поможем запустить Checkcraft, подобрать пример и разобраться с первым прогоном. Можно написать до скачивания.

Telegram-группа открытая: не публикуйте пароли, токены и конфиденциальные рабочие данные. Для первого вопроса достаточно описания задачи.

Можно написать напрямую support@checkcraft.ru

Без регистрации. Ответим по email. Это обращение в поддержку, а не подписка на рассылку.