APIリファレンス
Order Assignment API
Route creator orders to your fleet, programmatically.
The Order Assignment API lets logistics partners receive, accept, and manage delivery jobs as they are created across the FOODS network. Pull available jobs, accept them for a rider, and keep order state in sync with your own dispatch system.
機能
- Receive available delivery jobs in your zones
- Accept or decline jobs on behalf of a rider
- Reassign a job between riders
- Sync order lifecycle state with your dispatch system
エンドポイント
GET
/v1/orders/availableList unassigned jobs in your territories
POST
/v1/orders/{order_id}/acceptAccept a job for a rider
POST
/v1/orders/{order_id}/reassignMove a job to another rider
GET
/v1/orders/{order_id}Retrieve a single order
Accept an order for a rider
リクエスト
curl -X POST https://api.foodsbyme.com/v1/orders/ord_8Kd2/accept \
-H "Authorization: Bearer $FOODS_PARTNER_KEY" \
-H "Content-Type: application/json" \
-d '{ "rider_id": "rdr_19f3" }'レスポンス · 200 OK
{
"order_id": "ord_8Kd2",
"status": "assigned",
"rider_id": "rdr_19f3",
"pickup": { "creator": "Mama Titi's Kitchen", "eta_mins": 7 },
"dropoff": { "area": "Lekki Phase 1" },
"payout_estimate": { "currency": "NGN", "amount": 850 }
}