FAQ - Nouveau portail développeurs

Suivez la procédure suivante pour créer votre compte sur le nouveau portail développeur de la STM :

1. Accéder au portail par l’adresse https://portail.developpeurs.stm.info/apihub
   
   Note : La page sera en anglais et il n’est pas possible à cette étape de changer la langue. Suivez les captures d’écran suivantes pour vous orienter jusqu’à ce que vous puissiez changer la langue pour Français.
    
2. Cliquez sur le bouton « CREATE AN API HUB ACCOUNT »
   
   
    
3. Remplissez uniquement les deux premiers champs avec votre adresse courriel, laissez les champs « Organization or Workspace » et « Organization Description » vides, glissez le bouton « Slide to confirm » vers la droite et cliquez sur « SUBMIT ».
   
   
    
4. Sous peu, vous recevrez un courriel de confirmation avec le titre « Activez votre compte du Portail Développeur / Activate your Portail Développeur account »
   
   
   
   Cliquez sur l’hyperlien pour compléter votre enregistrement.
    
5. Remplissez tous les champs (dans l’ordre : prénom, nom de famille, nom d’usager, mot de passe, confirmation de mot de passe), lisez les termes d’utilisation (Terms of use), cochez la case et cliquez sur « ACTIVATE YOUR ACCOUNT »
    
6. Connectez-vous avec votre nouveau compte en utilisant le nom d’usager et le mot de passe choisi précédemment.
   
   
   
    

Changement de langue

Une fois connecté sur le portail, si vous le désirez, vous pouvez changer la langue d’affichage pour le français en cliquant sur le menu en haut à droite :

Le choix de langue sera gardé en mémoire dans votre navigateur. Cette opération sera à refaire si jamais vous videz sa mémoire tampon ou que vous utilisez un autre navigateur.

1. Allez dans la section Applications à gauche.
2. Cliquez sur AJOUTER UNE APPLICATION.
3. Saisissez le nom désiré, et indiquer une description au besoin, et cliquez sur SAVE.
4. Cliquez sur la section API, et pour chaque API désiré, cliquez sur le + pour l'ajouter à votre liste et acceptez les termes de conditions. Cliquez sur ENREGISTRER pour continuer.
5. Dans la section Authentifications et références, cliquez sur AJOUTER UNE CLÉ
6. Entrez un nom pour décrire votre clé d'API. Le nom doit être unique pour votre application.
7. Laissez les champs URL(s) de rappel/redirection et Portée vides
8. Laissez le Type à Public
9. Cliquez sur ENREGISTRER, et ensuite PUBLIER.
10. Pour voir votre clé d'API, cliquez sur la clé activée pour dévoiler ses détails. Note: Le Secret Partagé ne sert pas pour les APIs actuellement dans le portail, seule la clé d'API est requise.

Chaque API est documentée de deux façons:

1. L'onglet Spécifications de l'API inclus le document Swagger et les informations requises pour tester les APIs en ligne.
2. L'onglet Documentation de l'API contient un Wiki avec des informations complémentaires.

Chaque API est documentée de deux façons:

L'onglet Spécifications de l'API inclus le document Swagger et les informations requises pour tester les APIs en ligne.

L'onglet Documentation de l'API contient un Wiki avec des informations complémentaires.

Limitation du débit et quotas de requêtes

Chaque développeur est restreint à un maximum de 10 requêtes/seconde et d'un total de 10 000 requêtes/jour. Ces limites s'appliquent globalement à toutes les applications créées à partir d'un même compte, ou organisation.

En plus de ces limites individuelles, chaque API est associée à un profil de limitation de débit et de quota de requêtes par jour. Ces profils s'appliquent globalement et ne sont pas propre à chaque développeur. Le détail exact de ces profils sont gardés confidentiels afin de protéger l'intégrité de nos systèmes et la STM se réserve le droit d'en modifier les paramètres à tout moment en fonction de la capacité et de la demande.

La première des limites qui sera atteinte génèrera une des réponses suivantes:

Statut: 400
Message: Rate limit and/or quota exceeded.
Raison: Vous avez atteint votre limite individuelle (organisation)

Statut: 429
Message: {"error.message" : "API level rate limit exceeded"}
Raison: Vous avez atteint la limite globale de l'API

Dans tous les cas, il vous faudra réduire votre débit de requêtes par seconde ou attendre au lendemain avant de pouvoir réessayer à nouveau si le quota de requête par jour a été atteint.