İçeriğe geç
KuryeSoft

Kaynaklar

Müşteri takibi

Her siparişin müşteriyle paylaşılabilen bir canlı takip sayfası vardır: sipariş durumu, kuryenin haritadaki konumu ve tahmini varış.

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.
Bilgi:

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):

codemetin
Sipariş numarası.
statusmetin
Durum.
status_labelmetin
Durumun Türkçe adı.
restaurantnesne
İşletme.
restaurant.namemetin
Ad.
restaurant.latsayı
Konum.
restaurant.lngsayı
Konum.
destinationnesne
Teslimat adresi.
destination.addressmetin
Adres.
destination.latsayı
Konum.
destination.lngsayı
Konum.
couriernesne · boş olabilir
Kurye; atanmadıysa null.
courier.namemetin · boş olabilir
Kuryenin adı; firma gizlediyse null.
courier.phonemetin · boş olabilir
Kuryenin telefonu; yalnızca firma izin verdiyse ve paket yoldayken.
courier.vehicle_typemetin
Araç türü.

Değerler: motorcycle, car, bicycle, scooter, walk

courier.latsayı · boş olabilir
Kuryenin son konumu; yalnızca paket yoldayken.
courier.lngsayı · boş olabilir
Kuryenin son konumu.
courier.headingsayı · boş olabilir
Gidiş yönü (derece).
eta_attarih-saat · boş olabilir
Tahmini varış; yalnızca paket yoldayken ve firma gösteriyorsa.
created_attarih-saat
Siparişin alındığı an.
picked_up_attarih-saat · boş olabilir
Paketin yola çıktığı an.
delivered_attarih-saat · boş olabilir
Teslim anı.
companynesne
Kurye firmasının adı, logosu ve telefonu.
company.namemetin
Firma adı.
company.logo_urlmetin
Logo adresi.
company.phonemetin
Telefon.
200 · application/json (kısaltılmış)
{
  "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.