« Postman » : différence entre les versions

Aller à la navigation Aller à la recherche
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 &#62; PHP"
        },
        {
            "id": 2,
            "name": "Entité racine &#62; CAP"
        },
        {
            "id": 3,
            "name": "Entité racine &#62; MAD"
        },
        {
            "id": 4,
            "name": "Entité racine &#62; 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 :

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 &#62; PHP"
        },
        {
            "id": 2,
            "name": "Entité racine &#62; CAP"
        },
        {
            "id": 3,
            "name": "Entité racine &#62; MAD"
        },
        {
            "id": 4,
            "name": "Entité racine &#62; 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,
        ...
    }
]

Voir aussi

  •