Tham chiếu 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.
Khả năng
- 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
Endpoint
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
Yêu cầu
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" }'Phản hồi · 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 }
}