« Postman » : différence entre les versions
Aller à la navigation
Aller à la recherche
m (→Généralité) |
m (→Généralité) |
||
(4 versions intermédiaires par le même utilisateur non affichées) | |||
Ligne 2 : | Ligne 2 : | ||
== Généralité == | == Généralité == | ||
L'usage est notamment | L'usage est notamment la création ou la mise à jour en masse de données : | ||
* fiche fournisseur ; | * fiche fournisseur ; | ||
* fiche article emballage ; | * fiche article emballage ; | ||
Ligne 13 : | Ligne 13 : | ||
* https://www.postman.com/ | * https://www.postman.com/ | ||
** {{fichier|Postman-win64-Setup.exe}} | ** {{fichier|Postman-win64-Setup.exe}} | ||
== Référence == | |||
Welovedevs : Postman : le guide complet de l’outil indispensable au développement web | |||
* https://welovedevs.com/fr/articles/postman | |||
Guru99 : Tutoriel Postman - Comment utiliser pour les tests d'API ? | |||
* https://www.guru99.com/fr/Postman-tutorial.html | |||
OpenClassrooms : Adoptez les API REST pour vos projets web | |||
* https://openclassrooms.com/fr/courses/6573181-adoptez-les-api-rest-pour-vos-projets-web/7498761-utilisez-postman-pour-formuler-vos-requetes | |||
== Premiers pas == | |||
=== Requête d'obtention d'un jeton de session === | |||
<source inline>GET http://php100/glpi/apirest.php/initSession</source> | |||
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 :<source> | |||
{ | |||
"session_token": "qr042307m8jt9ah3j157e7429q" | |||
} | |||
</source> | |||
=== Liste des entités (avec récursivité) === | |||
<source inline>GET http://php100/glpi/apirest.php/getMyEntities/?is_recursive=true</source> | |||
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 : | |||
<source> | |||
{ | |||
"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" | |||
} | |||
] | |||
} | |||
</source> | |||
=== Liste des utilisateurs === | |||
<source inline>GET http://php100/glpi/apirest.php/User</source> | |||
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 : | |||
<source> | |||
[ | |||
{ | |||
"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, | |||
... | |||
} | |||
] | |||
</source> | |||
== Voir aussi == | == Voir aussi == |
Dernière version du 10 février 2024 à 14:22
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, ... } ]