API Carrier — Lister les missions

Description

Récupère la liste des missions (OTR) assignées à votre société transporteur. Supporte les filtres par statut, la pagination et un mode résumé enrichi.

Paramètres GET

Paramètre	Type	Défaut	Description
status	string	—	Filtre par statut. Valeurs : `create`, `assigne`, `en_cours`, `livre`, `incident`, `annule`, `actionable`
actionable_only	bool	0	Si `1` ou `true` : retourne uniquement les missions actionnables (exclut livré, annulé, refusé, créé)
limit	int	50	Nombre max de résultats (1–200)
offset	int	0	Offset pour la pagination
include_summary	bool	0	Si `1` : enrichit chaque mission avec chauffeur, véhicule, POD et dernier événement

💡 status=actionable est un raccourci équivalent à actionable_only=1.

Exemple de requête

GET /APIs/external/carrier_get_missions.php?status=actionable&limit=20
X-API-KEY: votre_cle_transporteur

Réponse (succès)

{
  "success": true,
  "count": 2,
  "missions": [
    {
      "id": 1060,
      "otr_number": "OTR-20260722-000001",
      "status": "assigne",
      "carrier_actionable": true,
      "pickup_date": "2026-07-28",
      "delivery_date": "2026-07-29",
      "delivery_name": "Client Dupont",
      "delivery_city": "Lyon",
      "reference1": "REF-001",
      "reference2": null
    }
  ]
}

Codes d'erreur

Code	Signification
401	Clé API absente
402	Abonnement inactif (essai terminé ou abonnement résilié)
403	Clé invalide, ou clé expéditeur utilisée sur un endpoint transporteur
400	Valeur de statut invalide
429	Trop de requêtes (120 par minute, 20 000 par jour) ; réessayer après `Retry-After`