إنتقل إلى المحتوى الرئيسي

التتبع

تتبع التوصيلات النشطة عبر دفع webhook (موصى به) و/أو استطلاع HTTP على مورد الطلب.

دفع Webhook​

اشترك في tracking.courier_locations عند إنشاء webhook:

{
  "url": "https://your-company.example.com/webhooks/lynq",
  "event_filters": ["tracking.courier_locations"],
  "tracking_interval_sec": 30
}
الحقلالقيود
tracking_interval_sec10–300 ثانية؛ افتراضي 30

كل دفعة تتضمن:

{
  "type": "tracking.courier_locations",
  "data": {
    "object": {
      "ts": 1715000030,
      "locations": [
        ["01ORDERULID", "01COURIERULID", 24.7136, 46.6753, 90.0]
      ]
    }
  }
}

كل صف: [order_ref, courier_ref, lat, lng, heading]. تحقق من X-Lynq-Signature كباقي الأحداث.

ملاحظة

دفعات التتبع fire-and-forget — صمّم لتلقي فجوات ودفعات مكررة.

الاستطلاع​

GET /orders/\{order_id\} يُرجع أحدث حالة وقد يتضمن حقول المندوب.

ذات صلة​