DEVELOPER
tramersorgu.com'un güçlü alt yapısına hoş geldin..
Api v1'e çok kolay bağlanacaksın, senin için her şeyi hazırladık, bize sadece 10 dakikanı ayırmalısın..
tramersorgu.com API servisi, üyelik sistemi ile müşterilerinizin mağazalarına kontrole gelen araçların "Hasar Kaydı, Kilometre Kaydı, Araç Detayları, Değişen Parça Kaydı" gibi bilgilere ve daha fazlasına sorunsuz ve güvenli bir şekilde ulaşabilmesi için geliştirilmiştir. Sorgu işlemlerini gerçekleştirebilmek için üye iş yerine özel "APİKEY" bilgisi kullanılır. Bu bilgiler tramersorgu.com tarafından üye iş yerine üyelik işlemleri tamamlandıktan sonra temin edilmektedir. Üye iş yerleri kendileri ile ilgili tüm bilgilere https://tramersorgu.com/uyelik-bilgileri adresinden ulaşabilir.
SENDEN NE İSTİYORUZ ?
Aşağıda bulunan tabloda listelenen parametreler ile
Test Ortamı için : https://tramersorgu.com/api/v1/developerCanlı Ortam için : https://tramersorgu.com/api/v1
Content-Type:application/json olacak şekilde,
POST veya GET Methodlarını kullarak istek atman yeterli.
Not : Aşağıdaki apikeyi testlerinde kullanabilirsin..
Zorunlu parametreler
| Parametre | Format | Açıklama |
|---|---|---|
| apikey | C99H161A-G4F3-B2F8-B7F7-2G3ER98F521K | https://tramersorgu.com/uyelik-bilgileri Adresinden canlı modda kullanmak için ulaşabilirsin |
| query | Hasar , Kilometre , Degisen , Aracdetay | Sorgu türünü belirtiyoruz. |
| datatype | Plaka , Sasi | Sorgu yapılacak araçta kullanılacak veri türünü belirtiyoruz. |
| data | 35XXX35, VB35XXXXX35XXXXXX | Plaka 6-12 , Şasi Numarası 11-17 Karakter aralığında olabilir. |
Opsiyonel parametreler
| Parametre | Format | Açıklama |
|---|---|---|
| selectchassis | integer | Sorgu yapılacak araç için çoklu seçim ekranı dönerse[multipleChassis]''e yanıt olarak gönderilmek zorundadır. |
| damagedate | YYYY-MM-DD | Değişen parça sorgularında zorunlu parametre olarak formatına uygun bir şekilde gönderilmelidir. |
| history | boolean | Geçmiş bir sorguyu listelemek için kullanılır. |
| returnurl | string | Geçerli bir web adresi olmak zorundadır. Sorgu işlemi bittiği zaman hedef adrese dönüş yapar. |
Dönüş yapılan parametreler
| Parametre | Format | Açıklama |
|---|---|---|
| queryid | string | Yapılan Sorgunun eşsiz kimliğidir. |
| userid | string | Sorguyu gerçekleştiren kullanıcın sistemlerimizde kayıtlı eşsiz kimliğidir. |
| date | YYYY-MM-DD | Sorgunun gerçekleştiği tarih. |
| hour | HH:MM:SS | Sorgunun gerçekleştiği saat. |
| starttime | string | Sorgunun başladığı zaman. |
| endtime | string | Sorgunun bittiği zaman. |
| processtime | string | Sorgunun gerçekleşme süresi. |
| clientip | string | Sorguyu gerçekleştiren istemcinin ip adresi. |
| amount | float | Sorgu ücreti. |
| currentamount | float | Sorgu esnasında tahsil edilen tutar. |
| historymode | boolean | Sorgu gerçekleşmeden geçmiş tarihte yapılan kayıt dönerse true döner. |
| returnid | string | Sorgunuz arkaplanda gerçekleşecekse yanıt için tanımlanan eşsiz kimlik bilgisi. |
| success | boolean | Sorgu işlemi kayıt bulduğu zaman true döner. |
| code | integer | Sorgu işleminin durumunu gösterir. |
| message | string | Sorgu işleminde hata olduysa açıklama döner. |
| list | object | Sorgu işlemi başarılıysa döner. İlgili sorguya dair verileri barındırır. |
Olası Sonuçlar
| Parametre | Kod | Açıklama |
|---|---|---|
| code | 0 | tramersorgu.com api sisteminde oluşan hatalar. |
| code | 1 | Sorgu işlemi başarıyla tamamlandı. |
| code | 100 | Araç Kilometre kaydı bulunmamaktadır. Araç Hasar Kaydı bulunmamaktadır. |
| code | 101 | Araç Sbm kayıtlarında poliçe bilgisi bulunmamaktadır. |
| code | 102 | Araç Sbm kayıtlarında rapor bilgisi bulunmamaktadır. |
| code | 103 | ilgili sorgu sisteminde ortaya çıkan hata mesajları. |
| code | 110 | ilgili sorgu servisine bağlantı kurulamadı. |
| code | 120 | PTT sisteminde araca ait birden çok kayıt var.(selectchassis ile seçim yapılması gerekiyor) |
| code | 130 | PTT sistemine özgü istisnai yakalanamayan hata. |
Örnek Sorgu GET METHOD
https://tramersorgu.com/api/v1/developer?query=hasar&apikey=C99H161A-G4F3-B2F8-B7F7-2G3ER98F521K&datatype=sasi&data=VBA12345678912345Örnek Sorgu POST METHOD
Kullandığınız yazılım dili ileContent-Type:application/json
olacak şekilde post edebilirsiniz.
{
"apikey":"C99H161A-G4F3-B2F8-B7F7-2G3ER98F521K",
"query":"hasar",
"datatype":"sasi",
"data":"VF1BZAA0543257909",
}
Sormak istediklerinizi ve önerileriniz info@tramersorgu.com adresine gönderebilirsiniz.
