===== Utilisation des APIs =====

==== Zebrix Control ouvert aux APIs ====

Les APIs de Zebbrix Control sont documentées au format OpenAPI. 

Vous pouvez les explorer directement depuis notre [[https://control.zebrix.net/api/v1/swagger#/|Swagger]] et télécharger leur définition en JSON ou YAML.

==== Création d’un token API  ====

Connectez-vous sur Zebrix Control puis cliquez sur votre nom en haut à droite pour vous rendre dans le menu **Préférences utilisateur**.\\

{{ .:pasted:20250529-234322.png?200 }}

Entrez une Description et une date d’expiration puis cliquez sur Créer le jeton d’accès personnel.

Veuillez copier et garder ce code, nous ne le stockons pas et il sera impossible à récupérer.\\

{{ .:pasted:20250529-234507.png?700 }}

{{ .:pasted:20250529-234714.png?700 }}

=== Utilisation du token dans les requêtes API ===

Le jeton généré correspond à un token d’accès personnel.
Il devra être utilisé comme Bearer Token dans l’en-tête HTTP Authorization pour toutes les requêtes APIs.

Ce token est l’élément qui sert à authentifier l’utilisateur lors de l’envoi des requêtes vers l’API Zebrix Control.

==== Format attendu ====

Toutes les requêtes doivent contenir l’en-tête suivante : **Authorization: Bearer VOTRE_TOKEN**

=== Exemple Postman ===

Dans Postman :

  * Ouvrez votre requête
  * Onglet Authorization
  * Type : **Bearer Token**
  * Collez votre token dans le champ Token

✅ Postman ajoutera automatiquement l’en-tête suivante : **Authorization: Bearer VOTRE_TOKEN**

==== Limitations ====

Zebrix Control applique une limite de 100 requêtes API par minutes.

L'utilisation des APIs repose sur un principe de ''fair use'' : tout abus pourra entraîner la suspension ou la fermeture du compte.