Servis Adresi
POST /DealerCustomer/GetCustomer
İstek Parametreleri
DealerCustomerAuthentication
| Parametre |
Açıklama |
| DealerCode string |
Ruut sistemi tarafından verilen bayi kodu |
| Username string |
Ruut sistemi tarafından verilen Api kullanıcı adı |
| Password string |
Ruut sistemi tarafından verilen Api şifresi |
| CheckKey string |
Kontrol anahtarı (DealerCode + "MK" + Username + "PD" + Password) String olarak birleştirilen bu bilgilerin SHA-256 hash algoritmasından geçirilmesiyle oluşturulur.
Buraya tıklayarak deneme ekranına gidebilirsiniz. |
DealerCustomerRequest
| Parametre |
Açıklama |
| DealerCustomerId integer |
Müşterinin, Ruut’ daki Unique Id’ sidir. CustomerCode gönderilirse zorunlu değil. Bu müşterinin bilgileri görülecektir. |
| CustomerCode string |
Bayinin, müşterisine verdiği Unique kod. DealerCustomerId gönderilirse zorunlu değil.Bu müşterinin bilgileri görülecektir. |
Örnek İstek (JSON)
{
"DealerCustomerAuthentication": {
"DealerCode": "xxx",
"Username": "xxx",
"Password": "xxx",
"CheckKey": "aabbccddeeff"
},
"DealerCustomerRequest": {
"DealerCustomerId": "",
"CustomerCode": "Customer"
}
}
Başarılı İstek Sonucu
Gönderilen istek verileri Ruut’ da başarılı bir şekilde işlenmişse, geri dönüş nesnesinin "ResultCode" alanında "Success" bilgisi yazar.
"Data" alanında ise dönen işlem sonucu bulunur. "Data" içinde yer alan bilgileri kontrol ederek akışlarınızı devam ettirebilirsiniz.
| Parametre |
Açıklama |
| DealerCustomerId integer |
Müşterinin, Ruut’ daki Unique Id’ sidir. |
| CustomerCode string |
Bayinin, müşterisine verdiği Unique kod. |
| Password string (opsiyonel) |
Müşteri saklı kartından çekim yapmak istediğinde, bayi, müşteri şifresinin de sorulmasını isterse bu alana müşterinin kendi şifresi girilir.
|
| FirstName string (opsiyonel) |
Müşteri Ruut sistemine ilk kez kaydedilecekse, müşterinin adı girilir. |
| LastName string (opsiyonel) |
Müşteri Ruut sistemine ilk kez kaydedilecekse, müşterinin soyadı girilir. |
| Gender integer (opsiyonel) |
Müşteri Ruut sistemine ilk kez kaydedilecekse, müşterinin cinsiyeti girilir. 1: erkek 2: kadın |
| BirthDate date (opsiyonel) |
Müşteri Ruut sistemine ilk kez kaydedilecekse, müşterinin doğum tarihi girilir. |
| GsmNumber string (opsiyonel) |
Müşteri Ruut sistemine ilk kez kaydedilecekse, müşterinin cep telefonu girilir. |
| Email string (opsiyonel) |
Müşteri Ruut sistemine ilk kez kaydedilecekse, müşterinin email adresi girilir. |
| Address string (opsiyonel) |
Müşteri Ruut sistemine ilk kez kaydedilecekse, müşterinin ikamet adresi girilir. |
| CardListCount integer |
Müşterinin saklanmış kartlarının sayısı. "0" |
| CardList array |
Bu servisle müşterinin kartları dönmez. |
Başarılı Sonuç Örneği
{
"Data": {
"DealerCustomer": {
"DealerCustomerId": 1033,
"CustomerCode": "Customer",
"Password": "Elif1234",
"FirstName": "Elif",
"LastName": "Y",
"Gender": 2,
"BirthDate": "19850710",
"GsmNumber": "5301111111",
"Email": "elif.y@ruutapp.com",
"Address": "TAŞDELEN"
},
"CardListCount": 0,
"CardList": []
},
"ResultCode": "Success",
"ResultMessage": "",
"Exception": null
}
Başarısız İstek Sonucu
Gönderilen istek verileri Ruut akışları içerisinde işlenemediyse, geri dönüş nesnesinin ResultCode alanında alttaki tablodaki hata kodlarından birisi bulunur.
Beklenmeyen yazılımsal bir hata oluştuğunda ise, ResultCode alanında EX yazar ve ResultMessage alanında alınan hata mesajı (Exception) yer alır.
Her iki durumda da, Data nesnesi null olarak gelir.
| ResultCode |
Açıklama |
| DealerCustomer.GetCustomer.InvalidRequest | CheckKey hatalı ya da nesne hatalı ya da JSON bozuk olabilir. |
| DealerCustomer.GetCustomer.CustomerCodeOrDealerCustomerIdMustBeGiven | Müşteri kodu veya bayi müşteri id girilmelidir. |
| DealerCustomer.GetCustomer.DealerCustomerNotFound | Bayi müşterisi bulunamadı. |
| DealerCustomer.GetCustomer.CustomerCodeDoesntMatchDealerCustomerId | Müşteri koduyla bayi müşteri id eşleşmiyor. |
| EX | Beklenmeyen bir hata oluştu |
Başarısız Sonuç Örneği
{
"Data": null,
"ResultCode": "DealerCustomer.GetCustomer.CustomerCodeOrDealerCustomerIdMustBeGiven",
"ResultMessage": "",
"Exception": null
}