API Tempo EDF gratuite (JSON, sans clé)

Name: Couleurs Tempo EDF et prévisions (JSON)
Creator: Calendrier Tempo EDF
License: https://creativecommons.org/licenses/by/4.0/

Calendrier Tempo EDF met à disposition une API JSON publique, sans inscription ni clé : couleur Tempo du jour et de demain, jours restants, nos prévisions à 15 jours et historique des couleurs.

Journalistes : chiffres et données citables dans le dossier de presse.

Les endpoints

Endpoints publics de l'API Tempo
Endpoint	Contenu	Cache
`GET /api/today`	Couleur officielle du jour	2 min
`GET /api/tomorrow`	Couleur officielle de demain, dès sa publication par EDF	2 min
`GET /api/remaining`	Jours restants par couleur dans la saison en cours	2 min
`GET /api/predictions`	Nos prévisions jour par jour (jusqu'à J+15), avec probabilités	2 min
`GET /api/history?days=30`	Couleurs officielles des N derniers jours (1 à 365)	aucun
`GET /api/performance/badge`	Taux de prévisions justes (faites 2 à 5 jours à l'avance) de la dernière saison complète, calculé sur les prévisions réellement émises, avec la couverture	5 min

Les couleurs officielles sont les couleurs publiées par EDF ; seule la couleur publiée par EDF fait foi.

Réutilisation libre en citant la source : calendrier-tempo.fr, avec un lien (licence CC BY 4.0).

/api/today et /api/tomorrow

Champs : status (ok ou unavailable), date (AAAA-MM-JJ), couleur (BLEU, BLANC ou ROUGE), code (1 = bleu, 2 = blanc, 3 = rouge). Tant qu'EDF n'a pas publié la couleur de demain, /api/tomorrow renvoie status: "unavailable", un message et code: 0 (couleur inconnue). EDF publie la couleur Tempo du lendemain chaque jour en fin de matinée, généralement vers 11 h.

Prix du kWh (réponse ok uniquement) : tarif donne le prix en heures pleines (hp) et en heures creuses (hc) de la couleur du jour concerné. /api/today ajoute tarifs : la grille des trois couleurs, sa date d'effet, l'unité (euros par kWh TTC) et les plages horaires (heures pleines de 6 h à 22 h). Entre 0 h et 6 h, la journée Tempo en cours est encore celle de la veille : le prix applicable est celui des heures creuses de la couleur de la veille.

$ curl https://www.calendrier-tempo.fr/api/today
{"status": "ok", "date": "AAAA-MM-JJ", "couleur": "BLEU", "code": 1,
 "tarif": {"hp": 0.1654, "hc": 0.1356},
 "tarifs": {"date_effet": "2026-08-01", "unite": "EUR/kWh TTC",
  "heures_pleines": "06:00-22:00", "heures_creuses": "22:00-06:00",
  "couleurs": {"BLEU": {"hp": 0.1654, "hc": 0.1356}, "BLANC": {"hp": 0.1921, "hc": 0.1536}, "ROUGE": {"hp": 0.7295, "hc": 0.1615}}}}

/api/remaining

Champs : remaining et totals (objets ROUGE / BLANC / BLEU), days_left_in_season, season_start, season_end, actuals_in_db et, quand ils sont disponibles, les compteurs relayés dans edf_official.

/api/predictions

Réponse : predictions (liste), generated_at, cycle_id. Chaque prévision de la liste contient les champs suivants.

Champs de la réponse de /api/predictions
Champ	Contenu
`date`	jour concerné (AAAA-MM-JJ)
`couleur_predite`	`BLEU`, `BLANC` ou `ROUGE`
`probabilite_bleu`, `probabilite_blanc`, `probabilite_rouge`	probabilité de chaque couleur, entre 0 et 1
`score_risque`	score de risque calculé par notre modèle (100 au maximum) : plus il est élevé, plus le jour risque d'être rouge
`temp_min_prevue`, `temp_max_prevue`	températures minimale et maximale prévues (°C)
`temp_moy_prevue`	température moyenne prévue en °C, pondérée sur 9 villes, 1 décimale, `null` si absente : c'est la valeur affichée sous chaque jour du calendrier
`raison`	explication courte de la prévision (« Couleur officielle EDF » une fois la couleur publiée)
`horizon`	libellé du délai de la prévision (par exemple `J-3`)
`confirmed`	`true` quand la couleur officielle EDF est connue : elle remplace alors la prévision

/api/history

Paramètre days (1 à 365, 30 par défaut). Réponse : history, liste de {"date": "AAAA-MM-JJ", "couleur_reelle": "ROUGE"}, couleurs officielles uniquement.

Exemple Home Assistant

Capteur REST qui lit la couleur du jour (à placer dans configuration.yaml) :

sensor:
  - platform: rest
    name: "Tempo couleur du jour"
    resource: https://www.calendrier-tempo.fr/api/today
    value_template: "{{ value_json.couleur }}"
    scan_interval: 3600

Configuration complète (demain, jours restants, prévisions, automatisation) et équivalents Jeedom et Domoticz : Tempo EDF en domotique.

Widget pour votre site

Pas besoin de code pour afficher la couleur du jour sur un site : notre widget Tempo EDF (badge ou cadre de prévisions sur 7 jours) se copie-colle, sans script ni cookie.

Codes HTTP et bonnes pratiques

200 : réponse normale (vérifiez le champ status).
503 : service en cours de démarrage, réessayez quelques secondes plus tard.
404 : endpoint inconnu.
Les réponses sont mises en cache 2 minutes : inutile d'interroger l'API plus souvent. Une requête par heure suffit pour la couleur du jour.
Aucune garantie de disponibilité : service gratuit et indépendant, non affilié à EDF ni à RTE.

Méthode de prévision et nature des chiffres de performance : méthodologie. Données des saisons passées : calendrier Tempo EDF.