# Sandbox et expéditions de test

> Des expéditions de test gratuites commençant par ZZZZ permettent de tester une intégration de la Container Tracking API sans frais — les statiques renvoient des données ou des erreurs fixes, les dynamiques évoluent en sept étapes, jour après jour ou figées.

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`](/fr/api/container-tracking/reference/get-shipment-detail) :

```bash
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](/fr/api/container-tracking/guides/error-codes) 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.

- `ZZZZ1000001` renvoie toujours l'étape 1.
- `ZZZZ1000004` renvoie toujours l'étape 4.
- `ZZZZ1000007` renvoie 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 |
