API başvurusu
Mesafe ve ücret hesapla
https://kurye.firmaniz.com/api/v1/quoteÖdeme ekranında müşteri adresini seçtiğinde çağırın: adres hizmet dışındaysa siparişi baştan almayabilirsiniz. Sistemde kayıt oluşturmaz.
Adres hizmet dışındaysa hata dönmez; yanıt 200 ile { "ok": false, "message": "..." } olur. message müşteriye gösterilebilir.
Ücret, kurye firmasının işletmeye tanımladığı fiyat profiliyle hesaplanır. Profil ödeme türüne ya da paket sayısına göre değişiyorsa kesin ücret siparişte hesaplanır ve buradakinden farklı olabilir.
İstek gövdesi
Content-Type: application/json. Belirtilmeyen alanlar varsayılan değeriyle kabul edilir; tanımsız alanlar yok sayılır.
restaurant_idtam sayıkoşullurestaurant_id ya da restaurant_code zorunludur; bağlıysa yok sayılır. Gövde yerine sorgu dizgisinde de gönderilebilir.restaurant_codemetinkoşullurestaurant_id yerine işletme kodu (ör. R001). Kodu kurye firmanız verir.latsayızorunlu-90 ile 90 arası
lngsayızorunlu-180 ile 180 arası
total_amountsayıEn az 0 · Varsayılan: 0
Örnek istek
curl -X POST "https://kurye.firmaniz.com/api/v1/quote" \
-H "X-Api-Key: $KURYESOFT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"lat": 40.9969,
"lng": 29.0342,
"total_amount": 285.5
}'Yanıt
200 Başarılı
Adres hizmet bölgesinde.
okmantıksaltrue: sipariş gönderilebilir.distance_mtam sayı · boş olabilirduration_stam sayı · boş olabilirdelivery_feesayı{
"ok": true,
"distance_m": 1754,
"duration_s": 253,
"delivery_fee": 70
}200 Hizmet dışı
Adres en fazla teslimat mesafesinin ya da hizmet bölgesinin dışında.
okmantıksalfalse.messagemetin{
"ok": false,
"message": "Adres en fazla teslimat mesafesinin (8 km) dışında"
}Hatalar
Hata gövdesi her zaman { "error": { "code", "message", "fields" } } biçimindedir. Bu uçta karşılaşabileceğiniz kodlar (bütün liste için Hatalar):
API_KEY_REQUIRED401ks_ ile başlamıyor.API_KEY_INVALID401VALIDATION422fields içinde yazar.NOT_FOUND404429 RATE_LIMITED ve 5xx yanıtlarında kısa bir beklemeyle yeniden deneyin. Bkz. Yeniden deneme.