Tous les articles

Résoudre les erreurs courantes de l'API REST

Situation

Lorsque vous travaillez avec l'API Wrike, les erreurs sont inévitables. 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 certaines des erreurs API les plus courantes et fournirons des étapes de dépannage pour vous aider à identifier et à corriger rapidement ces problèmes.

Important

Vérifiez toujours la documentation de l’API.

Re9ponses d9erreur

Voici un exemple de réponse d’erreur courante résultant d’une requête API ayant échoué.

Code d’état: XXX
Corps de la réponse:

{
"errorDescription": "human-readable description of the error.",
"error": "short, standardized code or identifier for the specific error that occurred"
}

Codes d9e9tat

300 - Plusieurs choix

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.

400 - invalid_request

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 d’utiliser le paramètre 'firstName' dans un appel GET/contacts appel

É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.

400 - invalid_parameter

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.

400 - method_not_found

Cause possible

Une me9thode API incorrecte est utilise9e.

Exemple : Un utilisateur tente d’envoyer un appel PUT/tasks qui n’est 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.

403 - not_allowed

Cause possible

L9action demande9e n9est pas autorise9e en raison de limitations de licence/de quota, etc.

  • L’utilisateur ne dispose pas des autorisations nécessaires pour exécuter l’action demandée.

    Exemple : Un utilisateur disposant d’un abonnement Business Plus appelle la méthode 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.
  • L’opération ne peut pas être exécutée.
    Exemple : Un utilisateur a tenté de créer une dépendance qui existe déjà.

É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.

404 - resource_not_found

Cause possible

  • La ressource demande9e n9existe pas.
  • L9utilisateur n9a pas acce8s e0 la ressource demande9e

Étapes de dépannage

Ve9rifiez la ressource demande9e et assurez-vous que l9utilisateur dont le jeton est utilise9 pour l9inte9gration y a acce8s.

429 - too_many_requests

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

429 - rate_limit_exceeded

Cause possible

La limite de de9bit est de9passe9e

Étapes de dépannage

Contactez notre équipe d'assistance clientèle

500 - server_error

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

Re9ponse vide

Cause possible

Vous essayez de re9cupe9rer une ressource qui n9existe pas.

Exemple : Un utilisateur envoie un appel pour récupérer des tâches d’un dossier vide avec l’appel 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 gérez plusieurs comptes Wrike et vous ne savez pas auquel votre jeton est rattaché ? Pas d’inquiétude, il est facile de l’identifier. Il suffit d’exécuter l’appel GET/account pour le confirmer.

Identifier le propriétaire de votre jeton

Si vous avez testé l’API avec plusieurs utilisateurs et que vous souhaitez connaître le propriétaire d’un jeton particulier, il existe une méthode simple et directe. Récupérez les informations du profil de l’utilisateur en envoyant un appel GET/contacts?me=true .

Contacter l'assistance

Si les obstacles 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 l’appel API.
  • La requête API complète que vous avez envoyée.
  • La réponse que vous avez reçue.

  • [En cas de problème lié aux autorisations ou au jeton]
    La partie centrale du jeton, afin que nous puissions le décoder de notre côté.

    Ci-dessous un exemple de jeton d’accès. Nous aurions besoin que vous nous envoyiez la partie comprise entre 2 points (mise en gras) et que vous supprimiez les parties avant et après le point :

    eyJ0dCI6InAiLCJhbGciOiJIUzI1NiIsInR2IjoiMSJ9.eyJkIjoie1wiYVwiOjM5MjA2MDIsXCJpXCI6NzIyMzMxOCxcImNcIjo0NjIwNzcwLFwidVwiOjY5NzA4NjcsXCJyXCI6XCJVU1wiLFwic1wiOltcIldcIixcIkZcIixcIklcIixcIlVcIixcIktcIixcIkNcIixcIkRcIixcIk1cIixcIkFcIixcIkxcIixcIlBcIl0sXCJ6XCI6W10sXCJ0XCI6MH0iLCJpYXQiOjE1OTk5MDk0MzV9.q3qOJs2swWSCgZl1ueKYsUyhME4RBD4cl53vZ0pwDcc

    Important

    Ne communiquez jamais le jeton entier ! Partager votre jeton permanent équivaut à partager le mot de passe de votre compte Wrike.

Haut

Articles associés