Referința 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.
Funcționalități
- 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-uri
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
Cerere
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" }'Răspuns · 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 }
}