Kaynaklar
Müşteri takibi
Takip bağlantısı
Sipariş yanıtındaki tracking_url alanı müşterinin açacağı sayfadır:
https://kurye.firmaniz.com/takip/oKe9xPqrlr7b_4jbNQiNCw
- Bağlantıyı siparişi onayladığınız e-postada, SMS'te ya da sipariş ekranınızda gösterin. Giriş gerektirmez.
- Sayfa kurye firmasının adı ve logosuyla açılır; paket yoldayken kuryenin konumu canlı güncellenir.
- Kurye firması müşteriye "yola çıktı" SMS'i gönderiyorsa aynı bağlantı o SMS'te de yer alır; müşteriye iki kez göndermemek için firmayla konuşun.
- Bağlantıdaki anahtar tahmin edilemez; yalnızca bağlantıyı bilen sayfayı açabilir. Yine de herkese açık yerlerde paylaşmayın.
Sayfada neyin görüneceğini kurye firması belirler: kurye adı, kurye telefonu ve tahmini varış ayrı ayrı açılıp kapatılabilir. Firma takip sayfasını tamamen kapattıysa bağlantı "Sipariş takibi kullanılamıyor" gösterir.
Kendi takip ekranınız için veri
Takibi kendi uygulamanızın içinde göstermek istiyorsanız, takip sayfasının kullandığı veriyi okuyabilirsiniz. Bu uç API anahtarı istemez; adresteki takip anahtarı yeterlidir (bağlantının son parçası ya da webhook gövdesindeki tracking_token).
curl "https://kurye.firmaniz.com/api/public/tracking/oKe9xPqrlr7b_4jbNQiNCw"Yanıtın konuyla ilgili alanları (yanıt ayrıca harita ayarlarını da içerir; onları yok sayabilirsiniz):
codemetinstatusmetinstatus_labelmetinrestaurantnesnerestaurant.namemetinrestaurant.latsayırestaurant.lngsayıdestinationnesnedestination.addressmetindestination.latsayıdestination.lngsayıcouriernesne · boş olabilirnull.courier.namemetin · boş olabilirnull.courier.phonemetin · boş olabilircourier.vehicle_typemetinDeğerler: motorcycle, car, bicycle, scooter, walk
courier.latsayı · boş olabilircourier.lngsayı · boş olabilircourier.headingsayı · boş olabilireta_attarih-saat · boş olabilircreated_attarih-saatpicked_up_attarih-saat · boş olabilirdelivered_attarih-saat · boş olabilircompanynesnecompany.namemetincompany.logo_urlmetincompany.phonemetin{
"code": "2611200042",
"status": "picked_up",
"status_label": "Yolda",
"restaurant": {
"name": "Lezzet Dürüm",
"lat": 40.9869,
"lng": 29.0262
},
"destination": {
"address": "Caferağa Mah. Moda Cad. No:12 Kadıköy",
"lat": 40.9969,
"lng": 29.0342
},
"courier": {
"name": "Ahmet Yılmaz",
"phone": null,
"vehicle_type": "motorcycle",
"lat": 40.992,
"lng": 29.03,
"heading": 40
},
"eta_at": "2026-11-20T18:31:28.000Z",
"created_at": "2026-11-20T18:10:32.000Z",
"picked_up_at": "2026-11-20T18:24:40.000Z",
"delivered_at": null,
"company": {
"name": "Kurye Firması",
"logo_url": "",
"phone": ""
}
}Sınırlar
- IP adresi başına dakikada 60 istek. Müşterilerinizin cihazları kendi IP'lerinden çağırırsa sınır sorun olmaz; bütün müşteriler için sunucunuzdan çağırırsanız sınır hepsine birden uygulanır.
- Tarayıcıdan, kurye firmasının alan adı dışındaki bir siteden yapılan çağrılar güvenlik politikası (CORS) nedeniyle engellenir. Mobil uygulamadan ya da sunucunuzdan çağırın.
- Paket yoldayken 15–30 saniyede bir yenilemek yeterlidir; sipariş sonuçlanınca yenilemeyi bırakın.
Çoğu entegrasyon için tracking_url bağlantısını paylaşmak hem daha kolay hem de canlı konum güncellemesini kendiliğinden içerir.