Ana içeriğe geç

loginMobile

Genel Bilgi

Özellik Değer
Endpoint Adı loginMobile
SOAPAction urn:WebticariService#loginMobile
Açıklama Mobil/PDA cihazlarda sisteme giriş yaparak oturum token'ı alır. Standart login'e ek olarak cihaz ID doğrulaması ve PDA modülü lisans kontrolü yapar.
Kimlik Doğrulama Gerektirir Hayır

İstek Parametreleri

Parametre Tip Zorunlu Açıklama
customerNumber xsd:string Evet 6 haneli müşteri numarası
username xsd:string Evet Kullanıcı adı
password xsd:string Evet Parola (düz metin)
deviceId xsd:string Evet Cihaza özgü benzersiz kimlik (UUID veya benzeri)

Yanıt

Başarılı girişte 40 karakterlik hexadecimal token döner.
Hata durumunda aşağıdaki hata kodlarından biri döner.

Hata Kodları

Dönüş Değeri Anlam
{token} Başarılı giriş — 40 karakterlik hex token
-1 Hatalı kullanıcı adı veya parola
-2 Sunucu hatası / token oluşturulamadı
-3 PDA/Terminal modülü için lisans izni yok
-4 Cihaz lisans limiti aşıldı (izin verilen maksimum cihaz sayısına ulaşıldı)
-5 Müşteri numarası formatı geçersiz (6 haneli olmalı)
-6 Brute-force koruması devreye girdi (9 ardışık başarısız deneme)
-7 Hesap askıya alınmış
-8 Hesap silinmiş

Token Davranışı

  • Token 30 dakika geçerlidir. Süre dolunca Invalid Token alınır ve yeniden giriş yapılmalıdır.
  • Aynı kullanıcı ile yeni giriş yapıldığında önceki token otomatik olarak geçersiz olur.
  • Cihaz başına lisans limiti aşıldığında (-4) sistem yöneticisiyle iletişime geçilmesi gerekir.

loginMobile ile login Arasındaki Farklar

Özellik login loginMobile
Device ID parametresi Yok Var
PDA modül lisans kontrolü Yok Var
Cihaz limit kontrolü Yok Var
Dönen token formatı Aynı Aynı

Örnek SOAP İstek

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:tns="urn:WebticariService">
  <soapenv:Header/>
  <soapenv:Body>
    <tns:loginMobile>
      <customerNumber>123456</customerNumber>
      <username>apikullanici</username>
      <password>Gizli123</password>
      <deviceId>550e8400-e29b-41d4-a716-446655440000</deviceId>
    </tns:loginMobile>
  </soapenv:Body>
</soapenv:Envelope>

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

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
  <soapenv:Body>
    <ns1:loginMobileResponse xmlns:ns1="urn:WebticariService">
      <return>a3f5c2b1d8e4f9a0b7c6d3e2f1a8b5c4d7e0f3a2</return>
    </ns1:loginMobileResponse>
  </soapenv:Body>
</soapenv:Envelope>

Örnek Yanıt — Cihaz Limiti Aşıldı

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
  <soapenv:Body>
    <ns1:loginMobileResponse xmlns:ns1="urn:WebticariService">
      <return>-4</return>
    </ns1:loginMobileResponse>
  </soapenv:Body>
</soapenv:Envelope>

Notlar

  • Bu endpoint PDA, mobil uygulama ve el terminali gibi cihazlara özel giriş için tasarlanmıştır.
  • deviceId değeri her cihaz için sabit ve benzersiz olmalıdır; bu değer cihaz lisans takibinde kullanılır.
  • PDA modülü aktif değilse (-3) sistem yöneticisiyle iletişime geçilerek modül aktifleştirilmelidir.