Servis Referansı

TOKEN WEB SERVİSİ

Kimlik Doğrulama ve Oturum Yönetimi API Dokümantasyonu

Token Web Servisi, Solventas API sisteminde kimlik doğrulama ve oturum yönetimi işlemlerini gerçekleştiren temel servistir. Bu servis üzerinden kullanıcı girişi, oturum sonlandırma, şifre değiştirme ve müşteri değiştirme işlemleri yapılabilir.

Endpoint-

WSDLhttps://apislv.solventas.com.tr/TokenWebService.asmx?WSDL

Metot Sayısı5

Metotları İncele Ana Dökümana Dön

Erişim Bilgileri

API Endpoint	apislv.solventas.com.tr
Protokol	SOAP 1.1 / SOAP 1.2
Veri Formatı	XML
Karakter Seti	UTF-8
Güvenlik	HTTPS + Token Tabanlı
WSDL URL	https://apislv.solventas.com.tr/TokenWebService.asmx?WSDL

Kimlik Doğrulama

Tablo bilgisi bulunamadı.

Standart Yanıt Yapısı

Tüm API metotları aşağıdaki standart yanıt yapısını döndürür (TResult):

Alan	Tip	Açıklama
Success	boolean	İşlem başarı durumu (true/false)
ErrorCode	int	Hata kodu (0 = başarılı)
Message	string	İşlem mesajı veya hata açıklaması
ReturnData	string	Dönen veri (JSON/XML formatında)
ReturnDatas	Array	Çoklu veri dönüşü
OldToken	string	Eski token değeri
NewToken	string	Yeni token değeri (yenilenmişse)
ResultCommand	string	Sonuç komutu

API Metotları

4.1 Kimlik Doğrulama ve Oturum Yönetimi

GetToken

SOAP / XML

Açıklama: Kullanıcı girişi ve token alma

Dönüş: Token ve kullanıcı bilgileri. Başarılı girişte ReturnData içinde token ve kullanıcı bilgileri döner.

Parametreler

Parametre	Tip	Zorunlu	Açıklama
UserName	string	Evet	Kullanıcı adı
Password	string	Evet	Kullanıcı şifresi

Örnek SOAP Gövdesi

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <GetToken xmlns="http://tempuri.org/">
      <UserName>...</UserName>
      <Password>...</Password>
    </GetToken>
  </soap:Body>
</soap:Envelope>

Logout

SOAP / XML

Açıklama: Oturumu sonlandırma

Dönüş: Başarı durumu. Oturum sonlandırılır ve token geçersiz hale gelir.

Parametreler

Parametre	Tip	Zorunlu	Açıklama
Token	string	Evet	Geçerli oturum token'ı
Key	string	Evet	Güvenlik anahtarı

Örnek SOAP Gövdesi

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <Logout xmlns="http://tempuri.org/">
      <Token>...</Token>
      <Key>...</Key>
    </Logout>
  </soap:Body>
</soap:Envelope>

ChangePassword

SOAP / XML

Açıklama: Şifre değiştirme

Dönüş: Başarı durumu. Şifre başarıyla değiştirildiğinde yeni token dönebilir.

Parametreler

Parametre	Tip	Zorunlu	Açıklama
Token	string	Evet	Geçerli oturum token'ı
Key	string	Evet	Güvenlik anahtarı
OldPassword	string	Evet	Mevcut şifre
NewPassword	string	Evet	Yeni şifre

Örnek SOAP Gövdesi

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <ChangePassword xmlns="http://tempuri.org/">
      <Token>...</Token>
      <Key>...</Key>
      <OldPassword>...</OldPassword>
      <NewPassword>...</NewPassword>
    </ChangePassword>
  </soap:Body>
</soap:Envelope>

ChangeCustomer

SOAP / XML

Açıklama: Müşteri değiştirme

Dönüş: Başarı durumu. Kullanıcının bağlı olduğu müşteri değiştirilir.

Parametreler

Parametre	Tip	Zorunlu	Açıklama
Token	string	Evet	Geçerli oturum token'ı
Key	string	Evet	Güvenlik anahtarı
CustomerCode	string	Evet	Müşteri numarası boş gönderilmelidir.

Örnek SOAP Gövdesi

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <ChangeCustomer xmlns="http://tempuri.org/">
      <Token>...</Token>
      <Key>...</Key>
      <CustomerCode>...</CustomerCode>
    </ChangeCustomer>
  </soap:Body>
</soap:Envelope>

4.2 Diğer Metotlar

HelloWorld

SOAP / XML

Açıklama: Test metodu

Dönüş: Test mesajı. Servis erişilebilirliğini kontrol etmek için kullanılır.

Parametreler

Tablo bilgisi bulunamadı.

Örnek SOAP Gövdesi

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <HelloWorld xmlns="http://tempuri.org/">
    </HelloWorld>
  </soap:Body>
</soap:Envelope>

Veri Tipleri

Veri Tipi	Açıklama
string	Metin verisi. Maksimum uzunluk API metoduna göre değişir.
int	Tam sayı. 32-bit işaretli tam sayı değeri.
float	Ondalık sayı. 32-bit kayan noktalı sayı.
boolean	Mantıksal değer. true veya false değeri alır.
Array	Dizi tipi. Çoklu veri içeren liste yapısı.
DateTime	Tarih ve saat. YYYY-MM-DD HH:MM:SS formatında.

Hata Kodları

Hata Kodu	Açıklama
0	İşlem başarılı
1	Geçersiz kullanıcı adı veya şifre
2	Geçersiz token
3	Token süresi dolmuş
4	Erişim yetkisi yok
5	Geçersiz parametre
6	Kayıt bulunamadı
7	İşlem başarısız
8	Veritabanı hatası
9	Sistem hatası
10	Geçersiz tarih formatı
11	Zorunlu parametre eksik
99	Bilinmeyen hata

Notlar ve Uyarılar

Token Web Servisi kullanım akışı aşağıdaki adımları içerir:

1. GetToken metodu ile kullanıcı adı ve şifre gönderilerek oturum açılır.

2. Başarılı giriş sonrası dönen token diğer API servislerinde kullanılır.

3. İşlemler tamamlandığında Logout metodu ile oturum sonlandırılır.

4. Şifre değiştirme gerektiğinde ChangePassword metodu kullanılır.

5. Farklı bir müşteri ile çalışmak için ChangeCustomer metodu kullanılır.

1. GetToken metodu kimlik doğrulama için kullanılır ve token döner.

2. Token parametresi diğer tüm API servislerinde kimlik doğrulama için kullanılır.

3. Key parametresi API erişim güvenlik anahtarıdır ve sistem tarafından sağlanır.

4. Token süresi dolabilir, bu durumda yeniden GetToken çağrısı yapılmalıdır.

5. Logout işlemi sonrası token geçersiz hale gelir ve tekrar kullanılamaz.

6. ChangePassword işlemi sonrası mevcut token geçersiz olabilir, yeni token alınmalıdır.

7. ChangeCustomer işlemi kullanıcının yetkili olduğu müşteriler arasında geçiş yapar.

8. Tüm metotlar SOAP 1.1 ve SOAP 1.2 protokollerini destekler.

9. API çağrılarında HTTPS protokolü kullanılmalıdır.

10. Bu servis tüm diğer Solventas API servisleri için temel kimlik doğrulama servisidir.