Documentation API

Intégrez Emprelio dans vos outils existants — ERP, comptabilité, Power BI, Zapier — via notre API REST sécurisée.

Accès API réservé aux plans Pro et Business.
Générez votre clé depuis Paramètres → Clé API.

Authentification

Toutes les requêtes API doivent inclure votre clé dans le header X-API-Key.

curl https://votre-domaine.fr/api/v1/history \
  -H "X-API-Key: emprelio_xxxxxxxxxxxxxxxx"

Codes d'erreur

Code	Signification
`401`	Clé API manquante ou invalide
`403`	Plan insuffisant (Pro/Business requis)
`400`	Requête invalide (paramètre manquant ou mal formaté)
`500`	Erreur serveur lors de l'analyse

Lancer une analyse CO₂

POST

/api/v1/analyze

⭐ Pro / Business

Envoie une liste de dépenses et reçoit un bilan carbone complet avec émissions CO₂ par catégorie.

Corps de la requête (JSON)

Champ	Type	Requis	Description
`company_name`	string	Requis	Nom de l'entreprise
`period`	string	Requis	Ex: `2024-T1`, `2024-annuel`
`expenses`	array	Requis	Liste de dépenses (max 500)
`expenses[].description`	string	Requis	Libellé de la dépense
`expenses[].amount`	number	Requis	Montant en euros
`expenses[].date`	string	Optionnel	Format `YYYY-MM-DD`
`save_to_history`	boolean	Optionnel	Sauvegarder dans l'historique (défaut: `true`)

curl -X POST https://votre-domaine.fr/api/v1/analyze \
  -H "X-API-Key: emprelio_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "company_name": "Ma Société SAS",
    "period": "2024-T1",
    "expenses": [
      {"description": "Air France Paris New York", "amount": 1200, "date": "2024-01-15"},
      {"description": "Electricite EDF bureaux", "amount": 450, "date": "2024-01-31"},
      {"description": "Uber taxi client", "amount": 80}
    ]
  }'

Réponse

{
  "company": "Ma Société SAS",
  "period": "2024-T1",
  "total_co2_kg": 326.4,
  "total_co2_tonnes": 0.326,
  "level": "faible",
  "biggest_source": "transport_avion",
  "items": [...],
  "recommendations": [...],
  "analysis_id": "b27d775f-..."
}

Historique des analyses

GET

/api/v1/history

⭐ Pro / Business

Récupère les dernières analyses de votre compte pour les intégrer dans un dashboard ou un rapport.

Paramètre	Type	Requis	Description
`limit`	integer	Optionnel	Nombre de résultats (défaut: 10, max: 50)

curl "https://votre-domaine.fr/api/v1/history?limit=5" \
  -H "X-API-Key: emprelio_xxxxxxxxxxxxxxxx"

[
  {
    "id": "b27d775f-...",
    "period": "2024-T1",
    "total_co2_tonnes": 0.326,
    "level": "faible",
    "date": "2024-01-31"
  }
]

Générer une clé API

POST

/api/generate

Génère ou régénère votre clé API (authentification JWT requise). Réservé aux plans Pro et Business.

curl -X POST https://votre-domaine.fr/api/generate \
  -H "Authorization: Bearer votre_jwt_token"

Révoquer une clé API

DELETE

/api/revoke

Révoque immédiatement la clé API. Toutes les intégrations utilisant cette clé seront bloquées.

curl -X DELETE https://votre-domaine.fr/api/revoke \
  -H "Authorization: Bearer votre_jwt_token"