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

• 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

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,
        ...
    }
]

•