« Postman » : différence entre les versions
Aller à la navigation
Aller à la recherche
m (→Voir aussi) |
mAucun résumé des modifications |
||
| Ligne 23 : | Ligne 23 : | ||
OpenClassrooms : Adoptez les API REST pour vos projets web | 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 | * 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 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> | |||
[ | |||
{ | |||
"id": 2, | |||
"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 == | ||
Version du 9 février 2024 à 22:38
Postman est une application permettant de tester des API. (Source : Wikipédia)
Généralité
L'usage est notamment la 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 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 :
[
{
"id": 2,
"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,
...
}
]