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

Авторизация API, Bearer Token и ошибки 401 и 403

Checkcraft — программа для проверки API и логов без кода, есть бесплатная версия. Скачать без регистрации →

Токен есть, но запрос всё равно возвращает 401. Причина может быть в способе передачи, сроке действия или выборе стенда, а не в теле JSON.

Подготовлено командой Checkcraft · Обновлено

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

Что получится

В форме запроса можно выбрать способ авторизации и проверить фактический ответ сервера. Учебный токен на снимке не даёт доступа ни к какой системе.

Настоящая форма авторизации Checkcraft. Для снимка использовано явно учебное значение demo-token-not-a-secret.
Настоящая форма авторизации Checkcraft. Для снимка использовано явно учебное значение demo-token-not-a-secret. Полный размер ↗

Передать Bearer-токен

Откройте авторизацию HTTP-запроса, выберите Bearer и укажите сам токен. Если заголовок задаётся вручную, его значение должно начинаться с Bearer и пробела. Не задавайте одновременно конфликтующие варианты в форме и ручном заголовке.

Authorization: Bearer YOUR_TEST_TOKEN

Использовать Basic Auth

Для Basic задайте тестовые username и password в соответствующих полях формы. Basic не является шифрованием, поэтому для реального удалённого сервера нужен HTTPS. Не публикуйте значение Authorization и не переносите рабочие пароли в учебные файлы.

Разобраться с 401

Проверьте, что токен не истёк, выдан для нужного сервиса и окружения, имеет необходимые права и не содержит лишних кавычек или переноса строки. Убедитесь, что адрес не ведёт на другой стенд или неожиданный редирект. Ответ сервера и его документация важнее предположения, что любой токен должен работать.

Проверить отказ отдельно

Успешный запрос с действующим токеном и отказ без токена являются разными тестами. Для каждого задайте ожидаемый HTTP-код и тело ответа по контракту. Если по требованиям должен быть 403, не заменяйте его на 401 только потому, что так ответил текущий стенд. Локальный пример условий ниже показывает проверку тела ошибки, но не имитирует настоящую авторизацию.

Повторить на готовых данных

Здесь лежит учебный тест-кейс для Checkcraft, правильный JSON и вариант с намеренной ошибкой. Файлы доступны без регистрации. Это данные для упражнения, а не доступ к чужому API.

Если приложение уже открыто

Создайте коллекцию, конструктор проверки и тест-кейс через контекстное меню дерева. В редакторе нажмите «Импорт» и выберите файл тест-кейса. Откройте добавленный тест. Скопируйте содержимое правильного JSON и нажмите «Вставить данные для анализа». Затем «Запустить тест-кейс» и вкладку «Результат».

Повторите те же действия с испорченным JSON, сохранив правила. В первом запуске ожидается успешная проверка, во втором ошибка. Если результат отличается, сравните импортированный тест, источник данных и текст отчёта.

Сверить с полученными при подготовке страницы отчётами можно по файлам успешного прогона и прогона с ошибкой. Примеры проверены 14 сентября 2026 года на текущем исходном коде приложения.

Почему HTTP 401 и 403 требуют разных проверок

При 401 сначала проверьте наличие и срок действия учётных данных, выбранное окружение и формат заголовка. При 403 запрос может быть распознан, но запрещён правами или политикой сервера. Фактическую причину подтверждают контракт и логи вашей системы. Не заменяйте ожидаемый статус на 200 только для зелёного отчёта.

Если токен получают предыдущим запросом

Проверьте цепочку запросов и передачу переменных. Для запроса, перенесённого из другого клиента, сверьте Authorization после импорта cURL. Успешная авторизация не заменяет проверки содержимого ответа из чек-листа API.

От примера к своей проверке

Посмотреть, как это работает на ваших данных

Можно начать с учебного файла на этой странице, увидеть найденную ошибку и затем заменить данные своим обезличенным примером. Для Windows и Linux доступна Free без ограничения срока.

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

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

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

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

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

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

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

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