خطط مسارات التوصيل في دقائق، لا ساعات

curl -sS -X POST "$DARB_API_BASE/api/v1/routes" \
  -H "Authorization: Bearer $DARB_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: route-2026-07-14-0001" \
  -d '{
    "start": { "lat": 23.60, "lng": 58.40, "label": "Depot" },
    "stops": [
      { "lat": 23.61, "lng": 58.41, "label": "A" },
      { "lat": 23.62, "lng": 58.42, "label": "B" }
    ]
  }'

{
  "id": "b6f1c0e2-4d3a-4c1b-9f22-0a1b2c3d4e5f",
  "status": "optimized",
  "stops": [
    { "seq_input": 1, "seq_optimized": 2, "eta": "2026-07-14T08:12:00Z", "label": "A", "lat": 23.61, "lng": 58.41 },
    { "seq_input": 2, "seq_optimized": 1, "eta": "2026-07-14T08:04:00Z", "label": "B", "lat": 23.62, "lng": 58.42 }
  ],
  "total_distance_m": 8450,
  "total_duration_s": 1320,
  "polyline": "yz{|@_ulpE...",
  "handoff_url": "https://<your-darb-app-host>/d/8f3c1a2b"
}

curl -sS -X POST "$DARB_API_BASE/api/v1/campaigns" \
  -H "Authorization: Bearer $DARB_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: campaign-2026-07-14-0001" \
  -d '{
    "contacts": [
      { "phone": "+12025550100", "name": "Ahmed" }
    ],
    "start": { "lat": 23.60, "lng": 58.40, "label": "Depot" },
    "deadline_at": "2026-07-15T17:00:00Z"
  }'

{
  "id": "3a9e7b10-6c22-4f88-b0d1-9e8f7a6b5c4d",
  "status": "completed",
  "route_id": "b6f1c0e2-4d3a-4c1b-9f22-0a1b2c3d4e5f",
  "purged_at": null,
  "contacts": [
    { "phone": "+12025550100", "name": "Ahmed", "state": "location_received", "lat": 23.615, "lng": 58.405 }
  ]
}

POST /your/webhook/endpoint HTTP/1.1
content-type: application/json
webhook-id: 550e8400-e29b-41d4-a716-446655440000
webhook-timestamp: 1783987200
webhook-signature: v1,K5oyc4Xr8m2xQ0y1x2s3D4e5F6g7H8i9J0kL1m2N3o=

{
  "type": "route.optimized",
  "timestamp": "2026-07-14T00:00:00+00:00",
  "data": {
    "route_id": "r_0d3f8c21",
    "status": "completed"
  }
}