2.8. API
2.8.1. Présentation
Note
La liste des endpoints est donnée dans le paragraphe Liste des endpoints.
L'exécution de ces endpoints peut se faire :
- via SWAGGER (Utilisation via l'interface graphique swagger) :ceci permet l'utilisation des endpoints et de comprendre son paramétrage et pouvoir tester son exécution et d'analyser ses résultats
via CURL (Utilisation via CURL) : ceci permet d'exécuter directement une requête Curl et de ne pas passer par l'interface graphique
2.8.2. Utilisation via l'interface graphique swagger
Chaque endpoint de l'API :
effectue une opération précise. Son nom et sa description sont indiquées dans l'interface graphique (ou dans la liste Liste des endpoints)
effectue une méthode parmi les quatre possibles : GET (Obtenir), DELETE (Supprimer), POST (Publier), PUT (Modifier)
a besoin de droits d'authentification qui sont les mêmes que pour l'interface graphique (Operators ou Administrators)
peut avoir besoin de paramètres de fonctionnement (entrée et /ou sortie) : par exemple, dans le cas d'un filtre, la valeur de ce filtre doit être indiquée.
Cette interface permet de :
avoir la liste des endpoints existants (listés par thème)
avoir le détail des paramètres éventuels pour l'exécution d'un endpoint
avoir des informations sur le résultat attendu (modèle des données et un exemple avec des valeurs par défaut)
exécuter des requêtes
récupérer la commande Curl équivalente à la requête via l'API
2.8.3. Utilisation via CURL
`Responses`
.Note
Envoi d’une requête pour lister les moteurs de la GBox (endpoint api/analysers) :
curl -X GET "https://x.x.x.x/api/analysers/" -H "accept: application/json" -H "authorization: Basic dG90bzpTYW5kcmluZSwxMDA=" -H "X-CSRFToken: PsMZMavgOibfe5giFCImu0YYTWqvB2AdhR1y"
où x.x.x.x est l'adresse IP de la Gbox.
2.8.4. Authentification et accès à l'API GBox
`API`
.