Sandbox et expéditions de test
La Container Tracking API fournit des expéditions de test dont l'interrogation ne coûte rien, pour tester une intégration avant de suivre de vraies expéditions. Leurs numéros commencent par ZZZZ. Chaque endpoint et chaque paramètre se comporte comme en production, et les dates de chaque réponse sont décalées à la date du jour, si bien que les données de suivi paraissent toujours récentes.
Utiliser une expédition de test
Envoyez le numéro de l'expédition de test comme shipmentNumber dans une requête à l'endpoint GET /shipment :
curl "https://api.sinay.ai/container-tracking/api/v2/shipment?shipmentNumber=ZZZZ0000000" \
-H "API_KEY: $SAFECUBE_API_KEY"
Expéditions de test statiques
Les expéditions de test statiques renvoient des données fixes qui ne changent jamais au fil du temps. Utilisez-les pour tester des réponses cohérentes et prévisibles.
| Numéro d'expédition | Réponse |
|---|---|
ZZZZ0000000 | Une expédition complète et sans anomalie du Havre à Rotterdam, avec l'historique complet de ses events. |
ZZZZ0000001 | Une erreur du fournisseur : la compagnie maritime n'a pas pu être détectée automatiquement (AUTO_CANT_DETECT_SEALINE). |
ZZZZ0000002 | Une erreur du fournisseur : la compagnie maritime n'a renvoyé aucune information (SEALINE_HASNT_PROVIDE_INFO). |
La page Codes d'erreur explique chaque code d'erreur.
Expéditions de test dynamiques
Les expéditions de test dynamiques simulent des scénarios réels, avec des données de suivi qui évoluent : mises à jour de position, changements de statut et nouveaux events. Chacune couvre une situation différente.
| Numéro d'expédition | Scénario |
|---|---|
ZZZZ100000 | Cycle de vie nominal complet : PLANNED, puis IN_TRANSIT, puis DELIVERED, puis une remise à zéro sur un nouveau voyage. |
ZZZZ200000 | Un voyage avec des erreurs du fournisseur injectées à certaines étapes, comme SEALINE_HASNT_PROVIDE_INFO et SEALINE_UNDER_MAINTENANCE. |
ZZZZ300000 | Un voyage nominal avec un transbordement : Le Havre, puis Anvers, puis Rotterdam. |
Chaque expédition de test dynamique passe par 7 étapes. Elle peut être interrogée de deux façons.
Évolution quotidienne automatique
Interrogez le numéro de base, long de 10 caractères, comme ZZZZ100000. L'étape renvoyée correspond au jour de la semaine en cours — le lundi est l'étape 1, le dimanche l'étape 7 — si bien qu'elle change automatiquement chaque jour et boucle chaque semaine. Utilisez-le pour des démonstrations en direct qui progressent d'elles-mêmes.
Étape figée
Ajoutez un chiffre de 1 à 7 au numéro de base, soit 11 caractères en tout, pour figer une étape quelle que soit la date. Utilisez-le pour des tests automatisés déterministes et reproductibles.
ZZZZ1000001renvoie toujours l'étape 1.ZZZZ1000004renvoie toujours l'étape 4.ZZZZ1000007renvoie toujours l'étape 7.
Un chiffre de suffixe supérieur à 7 renvoie 400 Bad Request.
Étapes de ZZZZ100000
| Étape (jour) | Statut |
|---|---|
| 1 (lundi) | PLANNED |
| 2 à 5 (mardi à vendredi) | IN_TRANSIT |
| 6 (samedi) | DELIVERED |
| 7 (dimanche) | PLANNED, nouveau voyage |