401 Unauthorized означает, что в запросе нет действительных учетных данных для доступа к целевому ресурсу. Несмотря на название, речь идет об аутентификации («кто вы?»), а не об авторизации. Сервер должен отправить заголовок WWW-Authenticate хотя бы с одним вызовом (challenge), например Basic realm="Staging" или Bearer, который сообщает клиенту, как пройти аутентификацию.
Если запрос уже содержал учетные данные, 401 означает, что их отклонили: неверный пароль или просроченный токен. Для вызовов Basic и Digest браузеры показывают окно входа. API возвращают 401 при отсутствующем или недействительном токене, чтобы клиент мог получить новый токен и повторить попытку.
Используйте 403 Forbidden, когда пользователь известен, но доступа у него нет, и 407, когда аутентификации требует прокси, а не исходный сервер.
Пример ответа
HTTP/1.1 401 Unauthorized
Date: Fri, 06 Nov 2026 10:15:32 GMT
WWW-Authenticate: Basic realm="Staging", charset="UTF-8"
Content-Type: text/plain; charset=utf-8
Content-Length: 23
Authentication requiredSEO и проверка редиректов
Страницы, закрытые аутентификацией, не могут попасть в индекс: поисковые роботы не входят на сайты, а URL, которые отдают 401, обрабатываются как другие ошибки 4xx. Для тестовых сайтов (стейджинга), админок и закрытого контента это именно то, что нужно, и HTTP-аутентификация гораздо надежнее, чем robots.txt, не пускает тестовый сайт в результаты поиска. Следите, чтобы на рабочем сайте случайно не остался пароль от тестового, и никогда не отвечайте поисковым роботам кодом 401 на публичных страницах.
Чтобы проверить защищенный URL в TrueURL, добавьте заголовок Authorization в разделе «Пользовательские заголовки запроса». Используйте для этого тестовые учетные данные.
Типичные причины и сценарии использования
- HTTP-аутентификация Basic защищает тестовый сайт или админку.
- API-токен отсутствует, просрочен или отозван.
- Сессия истекла, и API отвечает 401 вместо редиректа на страницу входа.
- Учетные данные потерялись при редиректе: многие клиенты отбрасывают заголовок
Authorization, когда редирект ведет на другой хост.