Créer une application
La première étape pour accéder à l'API est de créer une application sur EtuUTT. Pour cela, tout se passe sur le site, plus particulièrement sur le panel pour développeurs :
C'est d'ailleurs probablement par le biais de ce panel que vous avez découvert cette documentation.
Cliquez sur Créer une application. Quelques informations à propos de votre application vous sont alors demandées :
- le nom : il sera affiché sur la page d'autorisation utilisateur ;
- l'URL de redirection : l'URL vers laquelle l'utilisateur sera redirigé si il accepte l'accès ;
- une image, qui sera redimensionnée en 150x150 pixels et qui représentera votre application ;
- des droits : de quoi aura besoin votre application ? A quelles données voulez-vous qu'elle puisse accéder. Mettre tout n'est pas utile et risque même de faire fuir les utilisateurs : demandez seulement ce dont vous avez besoin ;
N'hésitez pas à acréer des applications de test, vous pourrez les supprimer par la suite si vous ne les utilisez plus.
Pour les applications mobiles, l'URL de redirection utilise une petite astuce. Nous l'aborderons dans la suite de la documentation.
Une fois créée, il vous est attribué deux données essentielles pour votre application :
- un Client ID, correspondant à l'identifiant de votre application ;
- un Client Secret, correspondant au mot de passe de votre application ;
Ces deux données sont privées, tout particulièrement le Client Secret. Ne les partagez avec personne, sous peine de voir votre application utilisée à mauvais escient.