Postman
Postman est une application permettant de tester des API. (Source : Wikipédia)
Généralité
L'usage est notamment la création ou la mise à jour en masse de données :
- fiche fournisseur ;
- fiche article emballage ;
- ...
Un compte est nécessaire (f22|gl) pour l'utilisation.
Source
Source :
- https://www.postman.com/
- Postman-win64-Setup.exe
Référence
Welovedevs : Postman : le guide complet de l’outil indispensable au développement web
Guru99 : Tutoriel Postman - Comment utiliser pour les tests d'API ?
OpenClassrooms : Adoptez les API REST pour vos projets web
Premiers pas
Requête d'obtention d'un jeton de session
GET http://php100/glpi/apirest.php/initSession
avec :
- Authorization : Username : phil
- Authorization : Password : glpi
- Headers : user_token : récupéré de la fiche utilisateur
- Headers : app_token : récupéré via le menu Configuration > Générale > API > Client API
résultat :
{ "session_token": "qr042307m8jt9ah3j157e7429q" }
Liste des entités (avec récursivité)
GET http://php100/glpi/apirest.php/getMyEntities/?is_recursive=true
avec :
- Headers : user_token : récupéré de la fiche utilisateur
- Headers : session_token : récupéré de la requête "jeton de session"
résultat :
{ "myentities": [ { "id": 1, "name": "Entité racine > PHP" }, { "id": 2, "name": "Entité racine > CAP" }, { "id": 3, "name": "Entité racine > MAD" }, { "id": 4, "name": "Entité racine > FRP" }, { "id": 0, "name": "Entité racine" } ] }
Liste des utilisateurs
GET http://php100/glpi/apirest.php/User
avec :
- Headers : user_token : récupéré de la fiche utilisateur
- Headers : session_token : récupéré de la requête "jeton de session"
résultat :
[ { "id": 2, "name": "glpi", "password_last_update": null, "phone": null, "phone2": null, "mobile": null, "realname": "Nom de famille", "firstname": "Prénom", "locations_id": 0, ... }, { "id": 3, "name": "post-only", "password_last_update": null, "phone": null, ... } ]