Gestion des erreurs
Cette section présente divers scénarios d'appels incorrects ou erronés, qui entraînent des messages d'erreur et des résultats inappropriés.
400 Mauvaise Demande
Le code d'état 400 est généralement observé lors du développement et de l'intégration et ne devrait pas être reçu lors des opérations normales. La réponse retournée contient les informations nécessaires pour corriger le problème.
De nombreux problèmes peuvent causer un code d'état 400 ; les plus courants sont listés dans le tableau ci-dessous.
Réponse | Résolution |
|---|---|
Renvoie si le numéro de concessionnaire est invalide. {
"status": 400,
"id": "rrt-0570f...",
"title": "bad_request",
"meta": {
"service": "01",
"detail": "The dealer number provided doesn't exist or is invalid."
}
} | Si le concessionnaire utilise votre DMS, il se peut qu'il ne soit plus un concessionnaire BRP. Vérifiez avec eux et désactivez les mises à jour de l'inventaire des pièces. Assurez-vous que le numéro du concessionnaire comporte 10 caractères. Si vous enregistrez le numéro du concessionnaire sans le '0' initial, ajoutez le '0' initial avant d'appeler l'API. L'erreur est également renvoyée si le concessionnaire n'est pas un concessionnaire BRP actif. |
Renvoie si une propriété est manquante. {
"fault": {
"faultstring": "OASValidation OAS-Parts_ordering with resource \"oas://OAS-Parts_ordering.json\": failed with reason: \"[ERROR - Object has missing required properties ([\"dealer_po_no\"]): []]\"",
"detail": {
"errorcode": "steps.oasvalidation.Failed"
}
}
} | Ajoutez la propriété manquante au payload. |
Renvoie si une propriété a un format invalide. {
"status": 400,
"id": "rrt-0a4d657a...",
"title": "bad_request",
"meta": {
"service": "01",
"code": "request validation failed",
"errors": {
"details": [
{
"message": "String \"096529\" is too short (length: 6, required minimum: 10): []"
}
]
}
}
} | Changez le format de chaîne de propriété pour qu'il corresponde au format de charge utile. |
401 Non autorisé
Le code d'état d'erreur 401 Non autorisé est renvoyé lorsque vous essayez d'appeler l'API des Transactions de Vente avec un access_token expiré.
Vous devez obtenir un nouvel access_token en appelant l' API d'authentification d'application.
413 Entité de requête trop grande
Le code d'état 413 Entité de requête trop grande est renvoyé lorsque la charge utile dépasse la limite de 10 Mo d'APIGee.
Notez que le code d'état 413 peut être reçu même si la charge utile que vous envoyez fait moins de 10 Mo. La charge utile est traitée avant d'appeler une API interne BRP, et cette API interne peut renvoyer le code d'état 413.
Pour corriger le problème, divisez les transactions en plusieurs appels.
504 Délai d'attente de la passerelle
Créer et Valider
Le Valider et Créer services renvoient le 504 Délai d'attente code d'état lorsque le nombre d'articles dépasse 25 ou 30.
Vérifiez la section Valider, Créer et Vérifier pour obtenir des informations sur la gestion du délai d'attente.
Obtenir
Le code d'état 504 Délai d'attente de la passerelle est principalement renvoyé par le Obtenir service lorsque la plage de dates utilisée dans la requête est trop grande, à peu près si la plage de dates est supérieure à 6 mois.
Changez la plage de dates pour une plus petite et appelez le Obtenir service à des dates différentes jusqu'à ce que toutes les commandes de pièces soient récupérées.