Ne anlama gelir
İstekte geçerli kimlik bilgileri yok. Adına rağmen kimliği doğrulanmamış demektir: giriş yapın veya geçerli bir token gönderin.
Yaygın nedenler
- Authorization başlığı eksik
- Süresi dolmuş veya iptal edilmiş token
- Yanlış kullanıcı adı, parola veya API anahtarı
Nasıl düzeltilir
İstemci veya ziyaretçiyseniz
Kimlik bilgilerini WWW-Authenticate başlığının istediği biçimde gönderin, süresi dolan token'ları yenileyin ve yazım hatalarını ya da yanlış ortamın anahtarını kontrol edin.
Sitenin veya API'nin sahibiyseniz
401 ile her zaman bir WWW-Authenticate başlığı ekleyin. Kullanıcının kimliği doğrulanmış ama yetkisi yoksa 403 kullanın.
Örnek yanıt
HTTP/1.1
HTTP/1.1 401 Unauthorized
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
WWW-Authenticate: Bearer realm="api", error="invalid_token"
Content-Type: application/problem+json
{
"type": "about:blank",
"title": "Unauthorized",
"status": 401,
"detail": "The access token expired."
}Belirtim
SSS
› 401 mi 403 mü?
401: kim olduğunuzu bilmiyoruz, kimliğinizi doğrulayın. 403: kim olduğunuzu biliyoruz ve bunu yapmanıza izin yok.
› Giriş yaptıktan hemen sonra neden 401 alıyorum?
Genellikle token isteklere eklenmiyordur (credentials olmadan CORS, yanlış başlık adı) ya da saat kayması onu süresi dolmuş gibi gösteriyordur.