Vous êtes sur la page 1sur 8

Definition de l’API REST

Qu’est-ce qu’une API ?

L’API, pour Application Programming Interface, est la partie du programme qu’on expose
officiellement au monde extérieur pour manipuler celui-ci. L’API est au développeur ce que
l’User Interface est à l’utilisateur. Cette dernière permet d’entrer des données et de les
récupérer la sortie d’un traitement. Initialement, une API regroupe un ensemble de
fonctions ou méthodes, leurs signatures et ordre d’usage pour obtenir un résultat.

Qu’est-ce qu’une API REST ?

Une API REST se doit d’être sans état ou stateless en anglais. La communication entre le
client et le serveur ne doit pas dépendre d’un quelconque contexte provenant du serveur.
Ainsi, chaque requête doit contenir l’ensemble des informations nécessaires à son
traitement. Cela permet au de traiter indifféremment les requêtes de plusieurs clients via
de multiples instances de serveurs.et permet d’automatiser les tâ ches.

Cas d'utilisation :

On accède à une ressource (par son URI unique) pour procéder à diverses opérations
supportées nativement par HTTP.

On peut demander à :

 Lire une ressource (GET).


 Modifier une ressource(PUT).
 Ecrire une ressource(POST).
 Supprimer une ressource (DELETE).
La configuration de API REST en GLPI  :
Etape1 :Activation de API REST en GLPI :

GLPI a partir de version 9.1 fournit une API REST de base.

vous pouvez utiliser l'API REST GLPI avec deux de nos développements:

     Rappels GLPI: première extension Google Chrome et Mozilla Firefox pour GLPI
     Gapp Self-Service: une application GLPI. (Android 6+)

en va accéder au compte super utilisateur ,


Vous pouvez l’activer dans Configuration > Générale > API et filtrer l’accès aux applications
externes.

La documentation d’utilisation est disponible sur : http://path/to/glpi/apirest.php .

Il y a 4 paramètres principaux:

L'URL de l'API est l'un des paramètres les plus importants dont vous aurez besoin pour
configurer votre application. Vous n'aurez pas besoin de le changer.

Maintenant, activez l'API REST en définissant la liste déroulante sur OUI.

Ensuite, vous devez choisir si vous allez utiliser les informations d'identification de
l'utilisateur, un jeton ou les deux (comme dans la capture d'écran ci-dessus). Activez celles
dont vous avez besoin et enregistrez les modifications.
Etape2 : Ajouter les clients correspondants aux IP autorisées à appeler l'API. :

Nous devons créer au moins un client API pour accorder à nos clients l'accès à celui-ci.

Revenons donc à notre précédente page de configuration de l'API et cliquez sur le bouton
Ajouter un client API.

Sur ce formulaire, vous pouvez activer plusieurs clients API, simplement:

1-Ajouter un nom descriptif

2- Réglez actif sur OUI.

Ce n'est pas obligatoire, mais vous devez vous connecter à chaque connexion. Vous
pouvez choisir entre l'activation des connexions de journal sur le journal GLPI ou sur un
fichier journal.

3- Enfin, vous pouvez filtrer l'accès par IP.

Enregistrez et vous êtes prêt à partir, sauf si l'application que vous utilisez prend en
charge le jeton d'application, auquel cas vous devrez le régénérer et l'ajouter à la
configuration de l'application. Il s'agit d'une couche de sécurité supplémentaire en option.
Accédez à votre profil utilisateur (chaque utilisateur doit effectuer cette étape), et dans la
section inférieure Clés d'accès à distance, cliquez sur Régénérer et enregistrer.

Ensuite, vous aurez un nouveau jeton d'API. Vous pouvez le copier en cliquant sur l'icô ne
de copie à droite. Collez-le ensuite sur la configuration de votre logiciel.

Si vous utilisez des rappels GLPI, cela ressemblera à ceci.

Pour automatiser la création d’un ticket :

On utilise URL suivant :
http://localhost/glpi94/apirest.php/Ticket/
et les fields suivant:
{"input": { "name": "monChangement1", "content": "contenu de mon changement"}}
Les point fort de API REST:
 Par défaut, l'API GLPI ne peut être accédée qu'à partir du même serveur.
 Api Fournit un contrô le complet de votre GLPI (afficher, ajouter, supprimer, ou actualisée
des actifs ou des tickets).
 Filtrer l'accès aux applications externes.
 Cacheable (avec cache = mémoire)

Les avantages de l’architecture REST ?????????

Comme les différentes règles et design pattern appliqués en génie logiciel, les différentes
contraintes qu’impose l’architecture REST permettent d’obtenir des applications de
meilleure qualité.

On peut citer entre autres :

 un couplage plus faible entre le client et le serveur comparé aux méthodes du type
RPC Remote Procedure Call comme SOAP;
 une uniformisation des APIs (Application Programming Interface) pour une facilité
d’utilisation;
 une plus grande tolérance à la panne;
 ou encore une application facilement portable et extensible.

Definition :

GLPI (gestionnaire libre de parc informatique) est un logiciel qui, comme son nom
l’indique, permet de gérer des parcs informatiques. Le projet GLPI a été réalisé par
l’association Independent. Ce logiciel est open-source, ce qui permet d’exécuter, modifier
ou développer le code.

En effet GLPI aide les entreprises à gérer leur système d’information. Ce dernier est très
utile pour des entreprises qui possèdent un grand nombre de machines tel que des
ordinateurs fixes ou portables, des imprimantes, des logiciels, etc…

GLPI comporte OCS NG, ce dernier va permettre de remonter toutes les machines ainsi que
les logiciels faisant partie d’un même réseau pour les répertorier dans GLPI. En effet on
peut soit ajouter des machines et des logiciels sur GLPI manuellement ou à partir d’OCS.

Dans cette présentation, nous profiterons des fonctionnalités de GLPI pour automatiser
l'ouverture des tickets afin d'éviter l’ouverture manuelle, c'est pourquoi nous proposons ces
solutions :
 Introduction
 Solution1 : L’ouverture de tickets par courriel
1. Définition
 Prérequis
 Contexte
2. Mise en œuvre du collecteur:
3. Point fort 
4. Point faible 
5. Remarque
 Solution2  : l’ouverture automatique avec le API REST
1. Définition
 Cas d'utilisation
2. La configuration de l’API REST en GLPI 
 Étape1 : Activation de l’API REST en GLPI
 Étape2 : Ajouter les clients correspondants aux IP
autorisées à appeler l'API
3. Pour automatiser l’ouverture d’un ticket 
4. Point fort 
5. Point faible 
 conclusion