Résoudre les erreurs courantes de l'API REST
Lorsque vous travaillez avec l9API Wrike, les erreurs sont ine9vitables. Elles peuvent se produire pour diverses raisons, telles que des droits utilisateur insuffisants, des limitations de licence du compte ou un formatage incorrect. Dans cet article, nous aborderons les erreurs d9API les plus courantes et fournirons des e9tapes de de9pannage pour vous aider e0 identifier et re9soudre rapidement ces proble8mes.
Important
Ve9rifiez toujours attentivement la documentation de l9API.
Voici un exemple de re9ponse d9erreur courante re9sultant d9une requeate API ayant e9choue9.
Code d9e9tat : XXX
Corps de la re9ponse :
{
\"errorDescription\": \"human-readable description of the error.\",
\"error\": \"short, standardized code or identifier for the specific error that occurred\"
}
Codes d9e9tat
Cause possible
URL de base incorrecte.
Étapes de dépannage
Ve9rifiez que votre URL de base est correcte.
Wrike stocke les donne9es clients dans plusieurs centres de donne9es situe9s aux c9tats-Unis et dans l9Union europe9enne. Pour acce9der e0 vos donne9es, utilisez l9URL de base approprie9e correspondant e0 l9emplacement de vos donne9es. Vous pouvez de9terminer votre URL de base en regardant l9URL dans la barre d9adresse lorsque vous acce9dez e0 votre compte Wrike dans un navigateur.
Cause possible
- Le type HTTP de la demande n'est pas valide, il manque des données critiques de la demande ou celles-ci présentent un format incorrect (il manque par exemple l'annexe).
- L9en-teate est manquant.
- Le nom du parame8tre de la requeate est invalide.
- Le parame8tre de la requeate n9est pas pris en charge pour cet endpoint.
Exemple : Un utilisateur tente d9utiliser le parame8tre 'firstName' dans un appel GET/contacts
Étapes de dépannage
- Ve9rifiez la documentation de l9API afin de vous assurer que votre requeate est correctement formate9e : tous les parame8tres doivent eatre valides et pris en charge par l9endpoint.
- Assurez-vous que tous les en-teates ne9cessaires sont inclus dans la requeate.
Cause possible
- Le parame8tre obligatoire est absent.
- La valeur du parame8tre est renseigne9e ou formate9e incorrectement.
Étapes de dépannage
- Ve9rifiez de nouveau la documentation et assurez-vous que tous les parame8tres marque9s comme obligatoires sont pre9sents dans votre appel.
- Assurez-vous que la valeur du parame8tre est correcte et formate9e selon la documentation.
Cause possible
Une me9thode API incorrecte est utilise9e.
Exemple : Un utilisateur tente d9envoyer un appel PUT/tasks qui n9est pas pris en charge.
Étapes de dépannage
Assurez-vous que la me9thode utilise9e est prise en charge pour l9endpoint et qu9elle est correctement de9finie.
Cause possible
L9action demande9e n9est pas autorise9e en raison de limitations de licence/de quota, etc.
- L9utilisateur ne dispose pas des autorisations ne9cessaires pour effectuer l9action demande9e.
Exemple : Un utilisateur avec un abonnement Business Plus exe9cute la me9thode GET/data_export.
-
Le compte n'a pas la licence nécessaire pour effectuer l'opération.
Exemple : Un Collaborateur tente de mettre à jour le titre d'un dossier. -
L9ope9ration ne peut pas eatre effectue9e.
Exemple : Un utilisateur a tente9 de cre9er une de9pendance de9je0 existante.
Étapes de dépannage
- Vérifiez les autorisations de l'utilisateur dans les paramètres du compte Wrike. Assurez-vous que l9utilisateur dispose des autorisations ne9cessaires pour acce9der e0 la ressource demande9e.
- Ve9rifiez la licence du compte. Vous devrez peut-être mettre à niveau la licence pour utiliser cette méthode API.
- Vérifiez si l'utilisateur peut effectuer la même opération dans l'interface utilisateur.
Cause possible
Le taux de requeates depuis la m9me adresse IP (500 / min) ou par utilisateur (400 / min) a de9passe9 la limite. Les 400 premie8res requeates par minute sont traite9es et toute requeate supple9mentaire renvoie le statut 429.
Étapes de dépannage
- Si vous recevez des re9ponses HTTP 429 e0 vos requeates, envisagez d9effectuer des nouvelles tentatives avec un backoff exponentiel.
- Re9partissez la charge entre plusieurs utilisateurs.
- Si le problème persiste, contactez notre équipe d'assistance clientèle
Cause possible
La limite de de9bit est de9passe9e
Étapes de dépannage
Cause possible
- Le serveur a rencontre9 une condition inattendue qui l9a empeache9 d9exe9cuter la requeate.
- L9utilisateur n9a pas acce8s e0 la ressource demande9e
Étapes de dépannage
- Consultez la page Statut Wrike pour ve9rifier s9il existe des incidents ge9ne9ralise9s.
- S'il n'y a pas d'incidents, contactez notre équipe d'assistance clientèle pour une analyse approfondie.
Cause possible
Vous essayez de re9cupe9rer une ressource qui n9existe pas.
Exemple : Un utilisateur envoie un appel pour re9cupe9rer des te2ches depuis un dossier vide avec l9appel GET/folders/{folderId}/tasks
c9tapes de de9pannage
Assurez-vous que la ressource (p. ex. te2che/dossier/projet, etc.) existe dans le compte.
Astuces de pro
Identifier le compte auquel appartient votre jeton
Vous jonglez avec plusieurs comptes Wrike et vous ne savez plus auquel votre jeton est attribue9 ? Pas d9inquie9tude, il est facile de le de9terminer. Il vous suffit d9exe9cuter l9appel GET/account pour le confirmer.
Identifier le proprie9taire de votre jeton
Si vous avez teste9 l9API avec plusieurs utilisateurs et souhaitez connaeetre le proprie9taire d9un jeton particulier, il existe une me9thode simple et directe. Re9cupe9rez les de9tails du profil de l9utilisateur en envoyant un appel GET/contacts?me=true.
Si les difficultés persistent, veuillez contacter notre équipe d’assistance et nous serons ravis de vous aider.
Pour accélérer la résolution, veuillez fournir les informations suivantes :
- Votre objectif avec l9appel API.
- La requeate API comple8te que vous avez envoye9e.
- La re9ponse que vous avez ree7ue.
-
[En cas de proble8me lie9 aux autorisations ou au jeton]
La partie centrale du jeton afin que nous puissions le de9coder de notre cf4te9.
Ci-dessous, un exemple de jeton dacce8s. Nous avons besoin que vous nous envoyiez la partie comprise entre deux points (mise en gras) et que vous supprimiez les parties avant et apre8s le point :eyJ0dCI6InAiLCJhbGciOiJIUzI1NiIsInR2IjoiMSJ9.eyJkIjoie1wiYVwiOjM5MjA2MDIsXCJpXCI6NzIyMzMxOCxcImNcIjo0NjIwNzcwLFwidVwiOjY5NzA4NjcsXCJyXCI6XCJVU1wiLFwic1wiOltcIldcIixcIkZcIixcIklcIixcIlVcIixcIktcIixcIkNcIixcIkRcIixcIk1cIixcIkFcIixcIkxcIixcIlBcIl0sXCJ6XCI6W10sXCJ0XCI6MH0iLCJpYXQiOjE1OTk5MDk0MzV9.q3qOJs2swWSCgZl1ueKYsUyhME4RBD4cl53vZ0pwDccImportant
Ne partagez jamais le jeton entier ! Partager votre jeton permanent e9quivaut e0 partager le mot de passe de votre compte Wrike.