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
401aldığı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"
}'