Vous avez expérimenté une première utilisation de l'GrasAPI REST de GLPI avec l'outil Postman. Cet outil est très pratique pour tester et déterminer les bons paramètres à définir dans vos requêtes d'API REST qui utilisent les protocoles HTTTP ou HTTPS.

Pour rappel il faut s'appuyer sur la documentation de l'API pour :

• connaître le point d'entrée (Endpoint) de l'API c'est à dire l'URL à utiliser ;
• connaître les types de requête proposés : GET, POST mais aussi DELETE, PUT et PATCH ;
• interpréter correctement les codes retour de réponse de l'API : 2xx (succès), 3xx (redirection) 4xx (erreur côté client), 5xx (erreur côté serveur) ;
• savoir utiliser les clés d'API pour s'authentifier et obtenir un jeton de session (session_token) ;
• fournir les paramètres nécessaire soit dans l'URL (Query string) ou dans l'entête (Header) ;
• gérer le format des données obtenues qui sont le plus souvent au format JSON.

Dans cette activité, vous allez réutiliser ce que vous avez expérimenté avec Postman pour exécuter des requêtes avec l'utilitaire cURL et le langage de programmation Python.

Pour obtenir un jeton de session, il faut effectuer une requête Init session en renseignant des paramètres dans l'entête (Headers) :

• le jeton d'application (App-Token) qui a été créé pour vous permettre d'utiliser l'API de GLPI. Demandez à l'enseignant de vous communiquer cet App-Token.
• une authentification soit par un couple de login /mot de passe soit en utilisant un jeton d'utilisateur (user_token). C'est cette deuxième méthode que vous allez utiliser.

C:> curl -X GET -H "Authorization: user_token uuu..." -H "App-Token: aaa..." "http://path/to/glpi/apirest.php/initSession"
{"session_token":"sss..."}

• script Python sessio_token.py

import urllib.parse
import requests
api = "http://path/to/glpi/apirest.php/initSession"
user_token = "uuu..."
App-Token = "aaa..." 
 
url = main_api + urllib.parse.urlencode({"key":key, "from":orig, "to":dest})
json_data = requests.get (url).json()
print(json_data)
 
 
C:> curl -X GET -H "Authorization: user_token uuu..." -H "App-Token: aaa..." "http://path/to/glpi/apirest.php/initSession"
{"session_token":"sss..."}

• A8 - La gestion des configurations avec GLPI