Token al

POST /Auth/login — OMS API · Kimlik Doğrulama

Size verilen API kullanıcı adı ve parolasıyla erişim token'ı (JWT) üretir. Diğer tüm uçlara bu token Authorization: Bearer <token> başlığıyla gönderilir.

  • Token süresi expire alanında döner; süre dolmadan yenisini alın (her istekte login çağırmayın).
  • Kullanıcınız birden fazla kiracıya (firma) bağlıysa tenant alanını gönderin; göndermezseniz yanıt HTTP 200, isSuccess: false, errorMesssage: "please select a tenant" ve data içinde seçilebilir kiracılar olur.
  • Kullanıcı adı/parola hatalıysa HTTP 401 döner.

İstek gövdesi

  • tenant (string): Kiracı (firma) kodu. Kullanıcı birden fazla kiracıya bağlıysa zorunludur; tek kiracılı kullanıcıda boş bırakılabilir.
  • password (string, zorunlu): Kullanıcının parolası.
  • username (string, zorunlu): Size verilen API kullanıcı adı.

Yanıtlar

  • 200: İstek işlendi. Token yalnızca isSuccess: true ise doludur.
  • 400: Gövde doğrulanamadı (zorunlu alan eksik, tip uyumsuz ya da JSON bozuk). Yanıt ASP.NET Core ValidationProblemDetails biçimindedir; errors alanı hangi alanın hatalı olduğunu gösterir.
  • 401: Kullanıcı adı/parola hatalı ya da kullanıcı pasif/rolsüz.
  • 500: Beklenmeyen sunucu hatası. Bu yanıt PascalCase alan adlarıyla döner (diğer yanıtlardan farklı olarak) ve null alanlar da yazılır.

200 yanıt alanları

  • data (string[]): please select a tenant durumunda kullanıcının seçebileceği kiracı kodları. Yalnızca doluysa döner.
  • token (string): Erişim token'ı (JWT). Sonraki isteklerde Authorization: Bearer <token> olarak gönderilir. Başarısızlıkta null.
  • expire (string<date-time>): Token'ın geçerlilik bitiş zamanı (UTC).
  • isSuccess (boolean, zorunlu): Token üretildiyse true.
  • statusCode (string): Kullanılmıyor; null döner.
  • errorMesssage (string): Token üretilemediyse sebep: please select a tenant (birden fazla kiracı, tenant gönderin), user does not have a tenant ya da pasif/rolsüz kullanıcı mesajı. Yalnızca doluysa döner.