Ana içeriğe geç

Giriş Yap - Login

POST https://webservis.ekupbilisim.com/api/outsource/auth/login
Bu, canlı tabandır. Geliştirme ve entegrasyon testleri için /api/outsource-test tabanını kullanın — bkz. Test Ortamı / Sandbox.

Kullanıcı yetkilendirme işlemleri için gerekli olan API uç noktası. Bu uç nokta, kullanıcıların sisteme giriş yapabilmesi için gerekli bilgileri alır ve doğrular.

  • Kullanıcı adı ve şifre bilgilerinizi destek ekibinden veya portal üzerinden alabilirsiniz.

Token Geçerlilik Süresi​

Başarılı girişte dönen extra.token değeri 1 saat geçerlidir. Süre dolduktan sonra yapılan çağrılar 401 Unauthorized döner — bu durumda /auth/login ile yeni token alınmalıdır.

  • Token'ı her istekte yeniden almayın; 1 saat boyunca aynı token'ı yeniden kullanın.
  • Uzun süren toplu işlemlerde (ör. çok sayıda belge gönderimi) süreyi takip edin ve 401 aldığınızda token'ı yenileyip isteği tekrarlayın.
  • Yenileme (refresh) uç noktası yoktur; yenileme = tekrar /auth/login.

JSON Parametreleri​

username string required
Sisteme erişim için kullanıcı adı bilgisi
password string required
Sisteme erişim için şifre bilgisi

Cevaplar ( Responses )​

200
OK
{
    "error": 0,
    "message": "İşlem başarıyla tamamlandı",
    "extra": {
      "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.easdfasdfsafasdfasdfasdf"
    }
  }
302
Yönlendirme — Onboarding/2FA
Gövde dönmez. Onboarding veya 2FA doğrulaması gerektiğinde yönlendirme bilgisi header'larda döner:

X-Redirect-Type: <onboarding|2fa>
X-Login-Id: <login-id>
422
Unprocessable Entity
{
"error": 1,
"message": "Form verileri ile ilgili sorun mevcut, lütfen verileri kontrol ediniz",
"fields": {
  "password": [
    "password zorunludur."
  ]
}
}
401
Unauthorized
{
  "error": 1,
  "message": "e-Posta veya şifre hatalı."
}
404
Not Found
{
  "error": 1,
  "message": "The route api/outsource/auth/login1 could not be found."
}
500
Server Error
{
  "error": 1,
  "message": "Sunucu Hatası"
}

Örnek İstek ( Curl )​


curl -X POST --location 'https://webservis.ekupbilisim.com/api/outsource-test/auth/login' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--data '{
"username": "VKN_TCKN/KullanıcıAdı",
"password": "Şifre"
}'