Codes d'erreur
La Container Tracking API signale deux sortes d'échec. Une réponse 200 avec un message d'erreur signifie que l'API a joint la compagnie maritime, mais que celle-ci n'a renvoyé aucune donnée de suivi. Une réponse 400, 405 ou 500 signifie que l'API n'a pas pu interroger la compagnie maritime du tout.
Réponses 200 sans données de suivi
Une réponse 200 avec l'un de ces messages signifie que la compagnie maritime a été détectée et a répondu, mais que sa réponse ne contient aucune donnée de suivi.
| Statut HTTP | Message | Signification |
|---|---|---|
200 | SEALINE_HASNT_PROVIDE_INFO | La requête a abouti. La compagnie maritime a répondu que rien n'a été trouvé pour cette expédition. |
200 | SEALINE_CANCELED_SHIPMENT | La requête a abouti. L'expédition est annulée. |
SEALINE_HASNT_PROVIDE_INFO est souvent temporaire : relancez la requête plus tard, la plupart de ces expéditions renvoient des résultats une fois que la compagnie maritime publie leurs données.
Réponses 400, 405 et 500
Une réponse 400, 405 ou 500 signifie que l'API n'a pas pu obtenir les informations auprès de la compagnie maritime. Une requête qui se termine par l'une de ces erreurs n'est pas facturée.
| Statut HTTP | Message | Signification |
|---|---|---|
400 | BAD_REQUEST | Des paramètres obligatoires manquent dans la requête. |
400 | Param: shipmentNumber cannot be null or empty | Le paramètre shipmentNumber est absent ou vide. |
400 | WRONG_NUMBER | Le numéro de conteneur, de connaissement ou de booking est invalide. |
400 | WRONG_SEALINE | Le code SCAC du transporteur est invalide. |
400 | WRONG_TYPE | Le type d'expédition est invalide. |
400 | Cannot convert value: {value} into request type: Boolean | Un paramètre booléen, comme route ou ais, a reçu une valeur autre que true ou false. |
400 | SEALINE_NO_RESPONSE | Une erreur est survenue pendant l'exécution de la requête : la compagnie maritime ne répond pas. |
400 | SEALINE_TEMPORARY_DISABLED | La compagnie maritime est temporairement désactivée. Réessayez plus tard. |
400 | AUTO_CANT_DETECT_SEALINE | La compagnie maritime n'a pas pu être détectée automatiquement. Renseignez le paramètre sealine. |
400 | AUTO_CANT_DETECT_TYPE | Le type d'expédition n'a pas pu être détecté automatiquement. Renseignez le paramètre shipmentType. |
400 | AUTO_CANT_FIND_INFO | Aucune information n'a pu être détectée automatiquement pour ce numéro. Renseignez les paramètres sealine et shipmentType. |
400 | SEALINE_NOT_SUPPORTED | Le code SCAC n'est pas pris en charge. GET /sealines liste les compagnies maritimes prises en charge et leurs codes SCAC. |
400 | TYPE_NOT_SUPPORTED_FOR_SEALINE | La compagnie maritime ne prend pas en charge ce type d'expédition. GET /sealines liste les types acceptés par chaque compagnie. |
400 | WRONG_PARAMETERS | Les paramètres de la requête sont invalides. |
400 | SEALINE_UNDER_MAINTENANCE | La compagnie maritime est en maintenance. Réessayez plus tard. |
405 | Method POST is not allowed | L'endpoint a été appelé avec une méthode HTTP qu'il n'accepte pas. |
500 | An unexpected error has occurred | Une erreur inattendue est survenue côté serveur. |
Réagir à une erreur
Quand une requête échoue, relancez-la, et renseignez les paramètres facultatifs que vous connaissez — le code SCAC sealine avant tout, puis le shipmentType. L'endpoint GET /sealines renvoie les compagnies maritimes prises en charge, leurs codes SCAC et les types d'expédition que chacune accepte.
Pour tester la façon dont une intégration gère ces erreurs, les expéditions de test gratuites ZZZZ0000001 (AUTO_CANT_DETECT_SEALINE) et ZZZZ0000002 (SEALINE_HASNT_PROVIDE_INFO) les renvoient à chaque requête. La page Sandbox et expéditions de test liste toutes les expéditions de test.