Довідник 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 }
}