| Les deux révisions précédentes Révision précédente Prochaine révision | Révision précédente |
| adel:utilisateurs:api-rest [2021/02/17 17:16] – [Documentation OpenAPI] eric | adel:utilisateurs:api-rest [2022/06/13 14:48] (Version actuelle) – eric |
|---|
| ===== Notes de version ===== | ===== Notes de version ===== |
| |
| * Dernière mise à jour de ce document : **le 16 février 2021** | * Dernière mise à jour de ce document : **le 9 septembre 2021** |
| | * Clarification de la forme de l'URL attendue au niveau de l'implémentation |
| * Version d'Adel utilisé lors des tests : **6.4.6** | * Version d'Adel utilisé lors des tests : **6.4.6** |
| * Version de l'API : **v1** | * Version de l'API : **v1** |
| ===== Documentation OpenAPI ===== | ===== Documentation OpenAPI ===== |
| |
| L'accès à la documentation technique de l'annuaire ADEL est le suivant : | L'accès à la documentation technique de l'annuaire ADEL est le suivant :\\ |
| | **<nowiki>https://secure.bayard-service.com/annuaire_<MON_ANNUAIRE>/swagger-ui/index.html</nowiki>** |
| **<nowiki>https://secure.bayard-service.com/annuaire_<MON_ANNUAIRE>/swagger-ui.html</nowiki>** | |
| |
| Cette documentation repose sur le standard [[https://www.openapis.org|OpenAPI]] et met à disposition une interface permettant de découvrir les possibilités de l'API mais aussi de **tester les différents services** offerts par celle-ci. | Cette documentation repose sur le standard [[https://www.openapis.org|OpenAPI]] et met à disposition une interface permettant de découvrir les possibilités de l'API mais aussi de **tester les différents services** offerts par celle-ci. |
| Les requêtes effectuées sur l'API nécessitent une authentification afin que l'API soit en mesure d'accéder aux données de votre base Adel. C'est pourquoi l'interface de la documentation technique en ligne affiche un bouton "//Authorize//" avec un cadenas ouvert qui précise que vous n'êtes pas encore authentifié. | Les requêtes effectuées sur l'API nécessitent une authentification afin que l'API soit en mesure d'accéder aux données de votre base Adel. C'est pourquoi l'interface de la documentation technique en ligne affiche un bouton "//Authorize//" avec un cadenas ouvert qui précise que vous n'êtes pas encore authentifié. |
| |
| Pour pouvoir tester les différentes "routes", il est donc nécessaire d'être authentifié. Pour cela, cliquez sur le bouton pour renseigner les informations d'identification. | Pour pouvoir tester les différentes "routes", il est donc nécessaire de l'être. Pour cela, cliquez sur le bouton pour renseigner les informations d'identification. |
| * ''username'' et ''password'' : correspondent à un compte d'accès Adel. Ce compte doit être habilité à utiliser l'API. | * ''username'' et ''password'' : correspondent à un compte d'accès Adel. Ce compte doit être habilité à utiliser l'API. |
| * ''client-id'' et ''client-secret'' : Mécanisme complémentaire d'authentification. Les informations à saisir sont à demander à Bayard-Service. | * ''client-id'' et ''client-secret'' : Mécanisme complémentaire d'authentification. Les informations à saisir sont à demander à Bayard-Service. |