API Expéditeur — Lister les OTR

Description

Renvoie les ordres de transport de votre société, du plus récent au plus ancien, avec filtres et pagination.

Clé API expéditeur dans l'en-tête X-API-KEY (ou Authorization: Bearer).

Paramètres (query string)

Paramètre	Type	Obligatoire	Description
status	string	Non	Filtre sur le statut (ex. `create`, `Validated`, `livre`)
client_id	int	Non	Filtre sur le client destinataire
from_date	date (AAAA-MM-JJ)	Non	Date d'enlèvement à partir de
to_date	date (AAAA-MM-JJ)	Non	Date d'enlèvement jusqu'au
limit	int	Non	Nombre de résultats, de 1 à 200 (50 par défaut)
offset	int	Non	Décalage pour la pagination (0 par défaut)

Exemple de requête

curl -X GET "https://shippinova.com/APIs/external/get_otrs.php?status=create&from_date=2026-01-01&limit=20" \
  -H "X-API-KEY: votre_cle_api"

Réponse (succès)

{
  "success": true,
  "count": 2,
  "otrs": [
    {
      "otr_id": 123,
      "otr_number": "OTR-20260122-093000-A1B2C3",
      "status": "create",
      "client_id": 5,
      "pickup_date": "2026-01-22",
      "delivery_date": "2026-01-23",
      "reference1": "REF-OTR-001",
      "reference2": null
    }
  ]
}

Codes d'erreur

Code	Signification
401	Clé API absente
403	Clé invalide, ou clé transporteur utilisée sur un endpoint expéditeur
429	Trop de requêtes (120 par minute, 20 000 par jour) ; réessayer après le délai `Retry-After`