🧩 Capfile API : Accédez aux données Enedis simplement

Pour les professionnels: Une passerelle standardisée pour connecter votre application aux compteurs.

Que vous soyez éditeur de logiciel, acteur de la gestion technique du bâtiment, agrégateur d’énergie ou intégrateur domotique, Capfile API vous permet d’automatiser la récupération, le suivi et l’intégration des données de consommation, d’index et de courbe de charge.

🚀 Fonctions principales

✅ Initier l’accès aux données d’un compteur (avec consentement utilisateur)
✅ Suivre l’avancement de la demande
✅ Récupérer les données une fois l’accès validé
✅ Recevoir automatiquement les mises à jour via un webhook sécurisé

🧰 API RESTful basée sur OpenAPI 3.0

Format : JSON
Méthodes supportées : GET, POST, PUT
Authentification : Basic, Bearer Token, ou API Key
Documentation complète au format OpenAPI (Swagger UI)

📘 Exemples de cas d’usage

Objectif	Endpoint utilisé
Initier un accès aux données	`POST /v1/access/init`
Suivre l’avancement	`GET /v1/access/{accessKey}/status`
Récupérer la courbe de charge	`GET /v1/access/{accessKey}/loadcurve`
Lire les index journaliers	`GET /v1/prm/{prm}/indexes`
Obtenir les infos techniques d’un compteur	`GET /v1/prm/{prm}/info`
Configurer un webhook	`PUT /v1/config/webhook`

🔐 Webhook sécurisé

Transmission en HTTPS POST
Signature HMAC SHA-256 dans l’en-tête X-Signature
Données incluses : access_key, PRM, type de mise à jour (loadcurve, indexes, etc.), période
Vérification de la signature côté serveur recommandée

🔧 Authentification flexible

Méthode	Détail
BasicAuth	identifiant + mot de passe
Bearer Token	via `POST /v1/login`
API Key	dans l’en-tête `X-API-KEY`

📎 Endpoints principaux

Méthode	URL	Description
`POST`	`/v1/access/init`	Créer une demande d’accès
`GET`	`/v1/access/{accessKey}/data`	Lire toutes les données
`GET`	`/v1/access/{accessKey}/indexes`	Lire les index
`GET`	`/v1/prm/{prm}/loadcurve`	Courbe de charge par PRM
`PUT`	`/v1/config/webhook`	Configuration du webhook
`POST`	`/v1/login`	Authentification API

👨‍💻 Pour qui ?

Développeurs intégrant les données Enedis dans un outil métier
Collectivités ou agriculteurs souhaitant automatiser la collecte de données pour leurs exploitations
Plateformes d’analyse, d’optimisation ou de facturation énergétique

🔹 API REST gratuite (particuliers)
Accédez facilement à vos données énergétiques via une API documentée.
Documentation : https://api.capfile.com/free/v1/doc/
🔹 Intégration Home Assistant
Importez vos données de consommation directement dans Home Assistant grâce à cette API.
Documentation : https://www.capfile.com/capfile/ha/doc/
Guide d’installation : https://www.capfile.com/capfile/ha/tuto/#1