38 | Gestion des erreurs
39 |
40 | Un code HTTP indique si l’appel a été correctement traité. Si ce code est différent de 200, cela signifie qu’un problème a été rencontré.
41 | En particulier, voici les différents codes d’erreur HTTP qui sont susceptibles d’être retournés :
42 |
43 |
44 | 400 : Bad Request
45 | L’url de l’appel est incorrect. Ce code correspond généralement à une valeur de paramètre incorrecte ou inexistante.
46 |
47 |
48 | 401 : Unauthorized
49 | Les informations d’authentification sont incorrectes ou absentes.
50 |
51 |
52 | 404 : Not Found
53 | L’appel a été correctement interprété et exécuté, mais la ressource demandée n’a pas été trouvée. En règle générale, cela indique que l’identifiant passé en paramètre est incorrect.
54 |
55 |
56 | 405 : Method Not Allowed
57 | L’url de l’appel est correct, mais la méthode utilisée n’est pas supportée par cette ressource. Par exemple, un appel GET a été réalisé sur une ressource ne pouvant être accédée qu’avec la méthode POST.
58 |
59 |
60 | 426 : Update Required
61 | L’appel a été correctement interprété, mais non exécuté. Ce code est retourné si l’appel est effectué dans un protocole non-sécurisé.
62 |
63 |
64 | 500 : Internal Server Error
65 | Une erreur de traitement a été rencontrée par les serveurs HelloAsso. Dans ce cas, le problème doit être remonté à notre équipe afin que nous puissions en déterminer l’origine et, le cas échéant, appliquer un correctif.
66 |
67 |
68 | 503 : Service Unavailable
69 | Ce code de retour indique que les serveurs HelloAsso sont surchargés. Dans ce cas de figure, l’appel doit être réitéré après le délai indiqué dans le champs d’en-tête Retry-After de la réponse.
70 |
71 |
72 | Outre le code de réponse HTTP, les appels en erreur retournent une réponse contenant plus d’informations sur l’erreur rencontrée. Ces informations apparaissent sous deux formats. Le premier est un message à destination humaine, donnant une indication sur la possible origine du problème. Par exemple, si l’erreur provient d’un paramètre malformé, cela sera indiqué dans le message, avec le nom du paramètre en question.
73 | Le deuxième format est un code d’erreur HelloAsso en notation reverse-domain, pouvant donc être automatiquement traité afin de mettre en place différents scénarios de réponses.
74 | Voici les différents codes de réponses susceptibles d’être retournés :
75 |
76 |
77 | com.helloasso.api.InvalidResource
78 | La ressource demandée n’existe pas. La raison en est probablement une url malformée.
79 | com.helloasso.api.MissingParameter
80 | L’accès à la ressource nécessite un paramètre qui n’a pas été fourni. Le message indique alors le paramètre concerné.
81 | com.helloasso.api.InvalidParameter
82 | Un des paramètres fournis n’est pas au format attendu. Le message indique alors le paramètre concerné.
83 | com.helloasso.api.InvalidIdentifier
84 | Un paramètre d’identifiant a été fourni, ne correspondant à aucune donnée enregistrée sur l’application.
85 | com.helloasso.api.NonSecureConnection
86 | L’appel a été réalisé en HTTP, sur une ressource imposant le protocole HTTPS.
87 | com.helloasso.api.ServiceUnavailable
88 | La ressource est actuellement indisponible pour cause de maintenance. Le message indique alors la nature de la maintenance et le temps d’attente estimé avant que la ressource soit à nouveau disponible.
89 | com.helloasso.api.ServerError
90 | Une erreur s’est produite lors du traitement de la demande.
91 |
92 |