Table of Contents

Erreurs fréquentes rencontrées lors de l'appel à une route d'API

Erreur 400 - Requête invalide

L'appel à la route d'API n'est pas valide. Par exemple:

  • un paramètre de requête obligatoire est absent de la requête.
  • la longueur de la donnée ne respecte pas ce qui est attendu. Par exemple, idEcole = 30125 au lieu de idEcole = 301

L'erreur est souvent associée à une validation de données qui ne concorde pas avec celle définie dans la route d'API.

Erreur 401 - Accès non autorisé

Cette erreur peut s'afficher lorsque:

  • l'identifiant client et le secret client sont erronés.
  • L'application définie dans Espace API n'est pas abonnée à la route demandée.
  • L'application définie dans Espace API est abonnée, mais elle n'a pas encore été approuvée par l'équipe de la GRICS.
  • La clé d'API IBM-X-Client-Id n'a pas été spécifiée dans les paramètres d'en-tête de la requête.
  • La base de données en lien avec l'API n'est pas à une version attendue.

Erreur 403 - Accès intedit

Cette erreur signifie que le jeton d'accès n'a pas le droit d'accéder à une route d'API qui elle est valide.

Par exemple, un enseignant adulte qui voudrait accéder aux données d'un enseignant jeune par l'appel de la route:

https://gateway.api.grics.ca/v2/999999/elevesJeunes

Erreur 404 - Ressource inexistante

Cette erreur survient lorsqu'il y a une erreur dans la route d'API.

Par exemple, dans la requête suivante, il manque un « s » à elevesJeunes

https://gateway.api.grics.ca/v2/988000/elevesJeune

Erreur 429 - Trop de requêtes

Toutes les routes API ont une limite de consommation par seconde et par jour. Au-delà d'une des limites, une erreur 429 sera déclenchée.

Par exemple, si la limite par seconde est de 30 appels, au-delà de cette limite vous ne pourrez plus récupérer de données.

Erreur 500 - Erreur interne

Cette erreur est normalement une erreur interne au serveur. Elle peut survenir lors d'une charge hors de l'ordinaire qui aboutit en un message de délai dépassé (timeout).

Elle peut aussi survenir si votre pare-feu bloque les adresses IP nécessaires au fonctionnement d'Espace API.
Voir la liste sur la page Cherche et trouve.

Une erreur 500 peut être se produire lors de l'appel des routes d'API Élèves. Certaines de ces routes nécessitent un appel à des données de la base de données Jade-Tosca pour les jeunes.

Assurez-vous d'avoir fait la configuration des bases de données JADE (FP, FGA) et JADE (FGJ) dans Mozaïk-Portail. Si vos bases de données de Jade-Tosca adulte et jeune sont fusionnées, inscrivez les mêmes informations dans la configuration de Mozaïk-Portail. Si vous n'avez pas accès à cette configuration, n'hésitez pas à ouvrir un billet dans Espace Client pour le produit Espace API.