Ana içeriğe atla
🚫 Tüm yetkili uç noktalar her istekte Authorization: Bearer <ACCESS_TOKEN> başlığı gerektirir.
Aksi takdirde API istemcisi 401 - Yetkisiz hatası alır ve çağrı engellenir.
Örnek başlık:
Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJtdXJhdG96ZGVtaXJAdGFybGEuaW8iLCJ1c2VySWQiOiJjOGI1OTQwZS01M2QyLTQwZGYtYTg4Yi0xMTBjODYxNTVjZmEiLCJyb2xlcyI6WyJBUElfVVNFUiIsIkFETUlOIl0sImxvY2FsZSI6InRyX1RSIiwidGltZVpvbmUiOiJFdXJvcGUvSXN0YW5idWwiLCJpYXQiOjE3NTMyMTA2MzQsImV4cCI6MTc1MzIxNDIzNH0.hfF1bjcNDhVthtpaZ_HkysA-zJH3VN1a6Sr59aRZbk0

1. Giriş İşlemi

🔐 Giriş işlemleri kullanıcı adı ve şifre kombinasyonu ile yapılır.
API Uç Noktası: /v1/auth/login
Örnek İstek Gövdesi:
{
  "username": "[email protected]",
  "password": "password"
}
Örnek Başarılı Yanıt:
{
    "username": "[email protected]",
    "type": "Bearer",
    "accessToken": "eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJtdXJhdG96ZGVtaXJAdGFybGEuaW8iLCJ1c2VySWQiOiJjOGI1OTQwZS01M2QyLTQwZGYtYTg4Yi0xMTBjODYxNTVjZmEiLCJyb2xlcyI6WyJBUElfVVNFUiIsIkFETUlOIl0sImxvY2FsZSI6InRyX1RSIiwidGltZVpvbmUiOiJFdXJvcGUvSXN0YW5idWwiLCJpYXQiOjE3NTMyMDc1OTAsImV4cCI6MTc1MzIxMTE5MH0.fTCunl7i7yQ8nAuughBpvpRfdH8VFK8uhZWeTrDOPAc",
    "refreshToken": "eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJtdXJhdG96ZGVtaXJAdGFybGEuaW8iLCJ1c2VySWQiOiJjOGI1OTQwZS01M2QyLTQwZGYtYTg4Yi0xMTBjODYxNTVjZmEiLCJsb2NhbGUiOiJ0cl9UUiIsInRpbWVab25lIjoiRXVyb3BlL0lzdGFuYnVsIiwiaWF0IjoxNzUzMjA3NTkwLCJleHAiOjE3NTMyOTM5OTB9.ozFiZzNPSUtzwvu3wuocA8q8t6MlqbyT6On2i0vSENQ"
}
⏳ Erişim belirteçleri yalnızca 1 saat geçerlidir; yenileme belirteçleri ise 1 gün boyunca kullanılabilir.
Olası Hata Yanıtları:
{
  "timestamp": "2025-04-14T16:58:22.22308754",
  "status": 401,
  "error": "Yetkisiz",
  "message": "Hatalı kimlik bilgileri",
  "path": "/auth/login"
}
{
"timestamp": "2025-04-21T16:35:54.095818",
"status": 401,
"error": "Yetkisiz",
"message": "Kullanıcı devre dışı",
"path": "/auth/login"
}

2. Erişim Belirteci Yenileme İşlemi

🔁 Erişim belirtecinin süresi dolduğunda, yenileme belirteci kullanılarak yenilenir.
API Uç Noktası: /v1/auth/refresh
Örnek İstek Gövdesi:
{
  "refreshToken": "eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJtdXJhdG96ZGVtaXJAdGFybGEuaW8iLCJ1c2VySWQiOiJjOGI1OTQwZS01M2QyLTQwZGYtYTg4Yi0xMTBjODYxNTVjZmEiLCJsb2NhbGUiOiJ0cl9UUiIsInRpbWVab25lIjoiRXVyb3BlL0lzdGFuYnVsIiwiaWF0IjoxNzUzMjA3NTkwLCJleHAiOjE3NTMyOTM5OTB9.ozFiZzNPSUtzwvu3wuocA8q8t6MlqbyT6On2i0vSENQ"
}
Cevaplar Giriş İşlemi’ne benzeridir.
⚠️ API isteğiniz 401 - Yetkisiz dönerse erişim belirtecinizi yenileyip tekrar deneyin.
🔐 Yenileme isteği de 401 veriyorsa, devam etmeden önce yeniden giriş yapın.