Guide API REST — Premiers pas

API REST EXAGROUP — Premiers pas

L'API REST vous permet d'intégrer et d'automatiser la gestion de vos services EXAGROUP dans vos propres applications et scripts.

Authentification

Toutes les requêtes nécessitent un en-tête d'authentification :

X-API-Key: VOTRE_CLE_API

Créez une clé API depuis Mon compte → Clés API. Consultez l'article Gérer vos clés API pour plus de détails.

URL de base

https://exagroup.org/api/v1/

Format des réponses

L'API retourne du JSON. Structure type :

{
  "success": true,
  "data": { ... },
  "message": "OK"
}

En cas d'erreur :

{
  "success": false,
  "error": "Description de l'erreur",
  "code": 401
}

Exemples de requêtes

Lister vos services

curl -H "X-API-Key: VOTRE_CLE" \
     https://exagroup.org/api/v1/services

Informations du compte

curl -H "X-API-Key: VOTRE_CLE" \
     https://exagroup.org/api/v1/account

Lister les factures

curl -H "X-API-Key: VOTRE_CLE" \
     https://exagroup.org/api/v1/invoices

Lister les tickets

curl -H "X-API-Key: VOTRE_CLE" \
     https://exagroup.org/api/v1/tickets

Créer un ticket

curl -X POST \
     -H "X-API-Key: VOTRE_CLE" \
     -H "Content-Type: application/json" \
     -d '{"subject":"Mon problème","message":"Détails...","priority":"normal"}' \
     https://exagroup.org/api/v1/tickets

Codes de réponse HTTP

• 200 — Succès
• 201 — Ressource créée
• 400 — Paramètres invalides
• 401 — Clé API invalide ou manquante
• 403 — Accès interdit
• 404 — Ressource introuvable
• 429 — Trop de requêtes (rate limiting)
• 500 — Erreur serveur

Rate limiting

L'API est limitée à 60 requêtes par minute par clé. En cas de dépassement, vous recevez une erreur 429. Consultez l'en-tête X-RateLimit-Remaining pour suivre vos quotas.