Activer et Configurer l'API REST

🔑 Générer et utiliser les Tokens API et Session

L'API REST de GLPI est nécessaire pour automatiser la configuration. Voici comment activer l'API et récupérer le token.

1

Activer l'API REST

1

Connectez-vous à votre interface GLPI.

2

Accédez à Setup > General > API.

3

Activez l'API en cochant Enable Rest API.

2

Générer le Token API

1

Accédez à Administration > Users.

2

Cliquez sur le compte utilisateur avec lequel vous souhaitez accéder à l'API.

3

Dans l'onglet User, cherchez API Token.

4

Cliquez sur Regenerate pour générer un nouveau token.

5

Notez votre token (par exemple, your_api_token), car il sera utilisé dans les commandes.

3

Exemple de configuration API

Pour toutes les commandes suivantes :

• URL API par défaut : http://localhost:8080/glpi/apirest.php/

• Token API : À insérer dans l’en-tête des requêtes.

Exemple de commande de test :

curl -X GET http://localhost:8080/glpi/apirest.php/initSession \
-H "Authorization: user_token your_api_token"

4

Obtenir un Token de Session

Avant d'envoyer toute requête à l'API, récupérez un session_token :

curl -X GET http://localhost:8080/glpi/apirest.php/initSession \
-H "Authorization: user_token your_api_token"

Résultat attendu :

{"session_token": "your_session_token"}

Note : Conservez le session_token pour l'utiliser dans toutes vos requêtes.

5

Fermer la session (important)

Une fois toute les étapes ci-dessous terminés, fermez la session pour des raisons de sécurité :

curl -X GET http://localhost:8080/glpi/apirest.php/killSession \
-H "Authorization: user_token your_api_token" \
-H "Session-Token: your_session_token"

---

🖥️ Configurer les Headers Communs dans Insomnia

Pour simplifier et organiser les requêtes à l’API REST de GLPI, Insomnia a été utilisé après la récupération des tokens API et Session. Insomnia est un client API graphique qui facilite la gestion des headers, la duplication des requêtes, et l’analyse des réponses JSON.

⚙️ Étapes dans Insomnia :

1

Configurez les headers communs

• Authorization : user_token your_user_token

• Session-Token : your_session_token

2

Sauvegardez cette première requête comme modèle.

3

Dupliquez-la pour toutes les futures actions en modifiant uniquement 

• La route (ex. /Entity/, /Location/).

• Le type de requête (GET, POST, PUT).

• Le corps JSON, si nécessaire.

❓ Pourquoi Insomnia ?

• Simplicité : Interface intuitive pour tester les API.

• Gain de temps : La duplication accélère la configuration.

• Organisation : Structurez vos requêtes en collections pour un suivi clair.

• Débogage : Visualisez les réponses JSON directement.

En utilisant cet outil, toutes les requêtes de configuration décrites dans les sections suivantes ont été simplifiées et exécutées de manière rapide et efficace.