Cette petite API lit l'estimation de consommation ilek du lendemain et renvoie un JSON simple.
  • PHP 97.8%
  • Dockerfile 2.2%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-10-06 23:11:11 +02:00
public Add ilek forecast API with Docker Compose 2026-10-06 23:11:11 +02:00
.dockerignore Add ilek forecast API with Docker Compose 2026-10-06 23:11:11 +02:00
.env.example Add ilek forecast API with Docker Compose 2026-10-06 23:11:11 +02:00
.gitignore Add ilek forecast API with Docker Compose 2026-10-06 23:11:11 +02:00
compose.yaml Add ilek forecast API with Docker Compose 2026-10-06 23:11:11 +02:00
Dockerfile Add ilek forecast API with Docker Compose 2026-10-06 23:11:11 +02:00
README.md Add ilek forecast API with Docker Compose 2026-10-06 23:11:11 +02:00

API personnelle ilek

Cette petite API lit l'estimation de consommation ilek du lendemain et renvoie un JSON simple.

Configuration

Copiez .env.example vers .env, puis renseignez votre adresse e-mail, votre mot de passe ilek et l'identifiant du contrat électrique. Ne publiez jamais ce fichier.

L'API se connecte automatiquement à POST /v2/sign_in et renouvelle ik_token_v2 à chaque requête. Le cookie de confiance longue durée etuix, que l'API de connexion ne renvoie pas, doit être copié une seule fois dans .env.

L'identifiant du contrat se trouve dans les outils de développement du navigateur, onglet Network, sur la requête consumptions :

  • ILEK_SUBSCRIPTION_ID : nombre situé après /subscriptions/ ;

Si le compte ne possède qu'un seul contrat électrique actif, vous pouvez laisser ILEK_SUBSCRIPTION_ID vide et il sera détecté automatiquement. S'il y en a plusieurs, l'API vous indiquera leurs identifiants.

Chargez ensuite les variables et démarrez le serveur :

set -a
source .env
set +a
php -S 127.0.0.1:8080 -t public

Utilisation

curl -H "Authorization: Bearer $API_KEY" http://127.0.0.1:8080/tomorrow

Docker Compose

Après avoir renseigné .env, démarrez le service en arrière-plan :

docker compose up -d --build

Pour vérifier son état ou l'arrêter :

docker compose ps
docker compose down

Réponse attendue :

{
  "date": "2026-10-07",
  "estimated_kwh": 13,
  "allowed_kva": 6,
  "is_complete": false,
  "source": "ilek",
  "retrieved_at": "2026-10-06T23:00:00+02:00"
}

estimated_kwh est la prévision de consommation du lendemain. allowed_kva est la puissance autorisée du compteur, pas une quantité d'énergie quotidienne.

Les cookies ne sont jamais écrits sur le disque et sont renouvelés automatiquement. Cette API utilise néanmoins une interface privée non documentée par ilek, qui peut changer sans préavis.

Erreur de certificat avec Devilbox

L'API détecte automatiquement les emplacements habituels du bundle CA. Si votre image utilise un autre chemin, ajoutez-le dans .env :

SSL_CERT_FILE=/etc/ssl/certs/ca-certificates.crt

La vérification HTTPS reste activée ; ne la désactivez pas.