Authorization

Base url : https://virtualapitest.hstmobil.com.tr

HST Mobil API'sini kullanabilmek için öncelikle giriş yapmanız gerekmektedir. Giriş yapabilmek için "Auth/login" endpointine bir POST isteği göndermelisiniz. Bu istek, kullanıcı kimlik bilgilerinizi ve giriş isteğinizi içermelidir.

post

Authorizations

Bearer

AuthorizationstringRequired

Please insert JWT with Bearer into field

Body

application/jsontext/jsonapplication/*+json

userNamestring · nullableOptional

passwordstring · nullableOptional

latstring · nullableOptional

longstring · nullableOptional

Responses

200

Success

No content

post

/api/Auth/login

HTTPcURLJavaScriptPython

POST /api/Auth/login HTTP/1.1
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 64

{
  "userName": "text",
  "password": "text",
  "lat": "text",
  "long": "text"
}

application/jsontext/jsonapplication/*+json

200

Success

No content

---

Authorization İstek Mesajı Parametreleri

Parametre	Tür	Zorunlu	Açıklama
userName	String	evet	Telefon (ApiKey)
Password	String (SHA512)	evet	Şifresi (ApiSecret)
Lat	String	evet	"1"
Long	String	evet	"1"

---

Lat ve Long değerleri, istek sırasında gönderilmesi gereken zorunlu bilgiler arasında bulunmaktadır. Ancak içerik olarak, bu bilgilere boş bir string değeri de gönderebilirsiniz. Bu konuyla ilgili örnekleri Postman koleksiyonu ve örnek projede inceleyebilirsiniz.

Servise gönderilecek örnek bir JSON dosyası şu şekildedir;

{
    "userName": "5**79989**",
    "password": "SHA512 Password değeri",
    "lat": "string" ,
    "long": "string" ,
}

---

Servisten gelen örnek bir response JSON dosyası şu şekildedir;

{
    "data":
            {
                "token": "............",
                "expiration": "2023-05-21T20:49:18.903674+03:00"
            },
     "success": true,
     "message": "Access token başarıyla oluşturuldu",
     "resultCode": "0000"
}

Her istekte authorization işlemi gerekmektedir. Bunun için Bearer token kullanılmaktadır. Api isteklerinde header ‘a parametre olarak "Bearer" eklenmelidir.

Örnek projede http.ts dosyası içinde axios ayarlarını yaparken bu şekilde tanımlandı.