Skip to navigation
Insurgateway APIAuthentication

Authentication Login

Kimlik Doğrulama - Giriş

Kullanıcıyı doğrular ve bir JWT erişim token’ı, yenileme token’ı (refresh token) ve token’ın son kullanma tarihini döndürür.

Uç Nokta (Endpoint)

POST {{baseUrl}}/api/Authentication/login

İstek Gövdesi (Request Body)

AlanTürZorunluAçıklama
UserNamestring✅Hesaba ait kullanıcı adı.
Passwordstring✅Hesaba ait şifre.
WebApiKeystring✅Uygulama için Web API anahtarı. Varsayılan erişim için "-" kullanılır.

Örnek İstek Gövdesi:

{
  "UserName": "<UserName>",
  "Password": "<Password>",
  "WebApiKey": "-"
}

Başarılı Yanıt (200 OK)

Başarılı bir istekte HTTP 200 OK durum kodu ile aşağıdaki JSON gövdesi döner:

AlanTürAçıklama
TokenstringSonraki kimlik doğrulamalı isteklerde kullanılacak JWT erişim token’ı.
RefreshTokenstringMevcut erişim token’ı süresi dolduğunda yeni bir token almak için kullanılan yenileme token’ı.
Expirationstring (ISO 8601)Erişim token’ının süresinin dolacağı UTC tarih ve saat bilgisi.

Örnek Başarılı Yanıt:

{
  "Token": "<JWT>",
  "RefreshToken": "<yenileme_tokeni>",
  "Expiration": "2026-03-13T12:01:11Z"
}

Hatalı Yanıt (400 Bad Request)

Giriş bilgileri yanlış olduğunda (kullanıcı adı veya şifre hatalı) HTTP 400 Bad Request durum kodu ile aşağıdaki metin döner:

Örnek Hatalı Yanıt:

Giriş bilgileri hatalı. Lütfen tekrar deneyin.

⚠️ Bu hata genellikle yanlış kullanıcı adı, hatalı şifre veya geçersiz API anahtarı gönderildiğinde oluşur.

Kullanım

Başarılı bir giriş işleminden sonra, dönen Token değerini Expiration zamanına kadar istek atabilirsiniz.

Request

This endpoint expects an object.

Response headers

Transfer-EncodingstringOptional
Content-TypestringOptional
Content-EncodingstringOptional
VarystringOptional
X-Frame-OptionsstringOptional
X-XSS-ProtectionstringOptional
X-Content-Type-OptionsstringOptional
Referrer-PolicystringOptional
Token-Expiredboolean
X-Powered-BystringOptional
DatestringOptional

Response

OK