Dépannage des intégrations d’API REST

Les problèmes liés aux API REST peuvent parfois s’avérer complexe, mais une approche systématique peut faciliter leur identification et leur résolution de manière efficace. Vous trouverez ci-dessous quelques erreurs courantes et solutions potentielles.

Erreur « Bad request » (Requête incorrecte)

Un tableau vide, tel que UDA, peut générer une erreur « Bad Request ». Il s’avère également utile de comparer le formatage de votre requête à celui des exemples de syntaxe cURL fonctionnant correctement et fournis par Chrome River afin de vous aider à repérer les problèmes qui déclencheraient cette erreur.

Si vous n’avez pas reçu l’exemple de syntaxe cURL pour les API avec lesquelles vous travaillez, veuillez contacter votre membre de l’équipe de mise en œuvre ou créer un dossier via notre portail du service d’assistance. Vous pouvez également consulter les pages Swagger accessibles via la boîte à outils de mise en œuvre pour obtenir des informations générales.

Erreur « 401 Unauthorized » (401 non autorisé)

Cela signifie généralement que vous n’avez pas eu accès à la ressource API spécifique. Il se peut également que vous utilisiez une clé API qui ne correspond pas à l’environnement dans lequel elle a été émise. Voir l’article Écran d’administration Gestion des clés API pour plus de détails.

Problèmes d’intégrité des données

Dans Chrome River Expense, tout attribut de relation d’entité sur les API Personne ou Allocation nécessite une entrée valide dans l’API Entité/Type d’entité. Si vous recevez l’une des erreurs suivantes, veuillez vérifier que l’entité que vous envoyez est disponible dans Chrome River.

POST / PATCH v4/persons 

• 422 Unprocessable Entity (WebDAV) (RFC 4918)

{
   "code": "INVALIDINPUT",
   "message": "Invalid entityCode=001 and/or entityTypeCode=OFF"
}

v4/persons/batch

• 207 Multi-Status (WebDAV) (RFC 4918)
• 422 Unprocessable Entity (WebDAV) (RFC 4918)

{
   "personUniqueId": "USA00108",
   "result": "FAIL",
   "errorMessage": "Invalid entityCode=001 and/or entityTypeCode=OFF"
}

Sensibilité à la casse

Des erreurs peuvent se produire en cas d’utilisation d’une casse inappropriée pour les données d’un champ.

Par exemple, si le champ Entité est envoyé sous la forme rolename au lieu de roleName, vous verrez

• 422 Unprocessable Entity (WebDAV) (RFC 4918)

{
   "code": "EMPTYFIELD",
   "message": "entityType, entity and role are all required for personEntities"
}