Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.payven.com.tr/llms.txt

Use this file to discover all available pages before exploring further.

Identity servisi üzerinden oturum başlatır, access ve refresh token alırsınız. Bu token’lar konsol işlemlerinde ve Identity API’sinde kullanılır.

​
Endpoint

POST /api/v1/auth/{slug}/login
Path parametresiAçıklama
slugKuruluşunuzun slug’ı. Platform yöneticisi iseniz platform.

​
İstek

curl -X POST https://identity.payven.com.tr/api/v1/auth/acme-bank/login \
  -H "Content-Type: application/json" \
  -d '{
    "username": "user@acme-bank.com",
    "password": "********"
  }'

​
İstek gövdesi

AlanTipZorunluAçıklama
usernamestring✅E-posta veya kullanıcı adı
passwordstring✅Parola

​
Yanıt

{
  "isSuccess": true,
  "message": "Başarılı.",
  "code": "200",
  "data": {
    "accessToken": "eyJhbGciOiJSUzI1NiIs...",
    "refreshToken": "eyJhbGciOiJIUzUxMiIs...",
    "expiresIn": 3600,
    "refreshExpiresIn": 1800,
    "tokenType": "Bearer"
  }
}
AlanAçıklama
accessTokenSonraki API çağrılarında Authorization: Bearer ... olarak gönderilir
refreshTokenAccess token süresi dolduğunda yenilemek için
expiresInAccess token’ın saniye cinsinden geçerlilik süresi (tipik: 3600)
refreshExpiresInRefresh token’ın geçerlilik süresi (tipik: 1800)
tokenTypeSabit: Bearer

​
Token kullanımı

Aldığınız accessToken değerini Identity API’sindeki tüm korumalı endpoint’lerde gönderin: 
GET /api/v1/me
Authorization: Bearer eyJhbGciOiJSUzI1NiIs...

​
Hata yanıtları

HTTPcodeAnlam
401INVALID_CREDENTIALSKullanıcı adı veya parola hatalı
403USER_DISABLEDHesap devre dışı
403USER_PENDING_APPROVALOnay bekliyor
404TENANT_NOT_FOUNDSlug bulunamadı
429RATE_LIMIT_EXCEEDEDÇok fazla başarısız deneme

​
Güvenlik notları

Login isteklerini sadece HTTPS üzerinden atın.
accessToken’ı tarayıcıda httpOnly cookie veya in-memory state’te tutun, localStorage’a yazmayın.
refreshToken’ı sadece sunucu tarafında saklayın.
Başarısız login denemeleri için account lockout mekanizmamız vardır — 5 hatalı denemenin ardından 15 dakika bekleme süresi devreye girer.