POST
Assigner un chauffeur à une mission
POST /APIs/external/carrier_assign_driver.php
Description
Affecte un chauffeur (et optionnellement un véhicule) à une mission depuis votre TMS. Si vehicule_id n'est pas fourni, le véhicule par défaut du chauffeur est utilisé. Si aucun défaut n'existe, une erreur 400 est retournée.
Disponible uniquement sur le plan Pro ou supérieur.
Corps de la requête (JSON)
| Champ | Type | Obligatoire | Description |
|---|---|---|---|
| otr_id | int | Oui | ID de la mission |
| chauffeur_id | int | Oui | ID du chauffeur (doit appartenir à votre société) |
| vehicule_id | int | Non | ID du véhicule. Si absent, le véhicule par défaut du chauffeur est utilisé. |
Exemple de requête
POST /APIs/external/carrier_assign_driver.php
X-API-KEY: votre_cle_transporteur
Content-Type: application/json
{
"otr_id": 1060,
"chauffeur_id": 42,
"vehicule_id": 7
}
Réponse (succès)
{
"success": true,
"otr_id": 1060,
"otr_number": "OTR-20260728-000001",
"chauffeur_id": 42,
"vehicule_id": 7,
"vehicule_source": "provided",
"driver": { "id": 42, "name": "Jean Martin", "phone": "+33600000001" },
"vehicle": { "id": 7, "immatriculation": "AA-123-BB" },
"notification_sent": true,
"driver_workload_warning": null
}
💡 vehicule_source vaut provided si vous avez fourni le vehicule_id, ou driver_default si le défaut du chauffeur a été utilisé.
Codes d'erreur
| Code | Signification |
|---|---|
| 401 | Clé API absente |
| 402 | Abonnement inactif (essai terminé ou abonnement résilié) |
| 403 | Clé invalide, clé expéditeur, ou formule Starter (Plan upgrade required : Pro requis) |
| 400 | otr_id / chauffeur_id manquant, ou aucun véhicule disponible |
| 404 | Mission ou chauffeur introuvable pour votre société |
| 409 | Mission non actionnable |
| 429 | Trop de requêtes (120 par minute, 20 000 par jour) ; réessayer après Retry-After |