API Tempo EDF gratuite (JSON, sans clé)
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
| 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. À partir du 1er novembre 2026, RTE publie aussi les jours « PP » (période de pointe) de son mécanisme de capacité : dès l'avant-veille avant 12 h lorsque c'est possible, au plus tard la veille à 9 h 30, sans jamais revenir sur un jour publié. Un jour PP correspond à un jour rouge Tempo, sauf cas exceptionnel lié à un signal EcoWatt. L'annonce officielle de la couleur Tempo reste faite la veille, par RTE à 10 h 30, jusqu'au 1er novembre 2027. À partir du 1er novembre 2027, RTE pourra annoncer certains jours rouges dès l'avant-veille (délibération CRE n° 2026-189).
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.
| 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, lisible par un particulier (par exemple « Dimanche : toujours bleu (règle EDF) », « Couleur officielle EDF » une fois la couleur publiée) |
raison_technique | détail interne du calcul, sans engagement de format (depuis le 31/10/2026 ; c’était le contenu de raison auparavant) |
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 |
hesitation | true quand la prévision hésite entre deux couleurs : moins de 30 points d'écart entre la couleur prévue et la deuxième couleur la plus probable, et plus de 15 % pour cette deuxième couleur, le rouge étant l'une des deux (jamais pour un jour confirmé) |
seconde_couleur | la deuxième couleur (BLEU, BLANC ou ROUGE) quand hesitation vaut true, sinon null |
tendance | true au-delà de 5 jours : prévision lointaine, moins sûre, à reconfirmer |
libelle | texte prêt à afficher : la couleur prévue (« Blanc ») ou, si la prévision hésite, les deux couleurs (« Rouge ou blanc ? ») |
/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: 3600Configuration complète (demain, jours restants, prévisions, automatisation) et équivalents Jeedom et Domoticz :
Tempo EDF en domotique. Exemples de scénarios (batterie, préchauffage) qui anticipent
un jour rouge à J+2 avec /api/predictions :
scénarios domotiques pour les jours rouges.
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.
L'API est gratuite. Sans inscription, sans clé.
Vous pouvez l'utiliser tout de suite, rien à demander. Mêmes données et mêmes réponses pour tout le monde.
$ curl https://www.calendrier-tempo.fr/api/todayEnvie de suivre vos appels ? Créez une clé de suivi (facultative, gratuite elle aussi)
La clé ne débloque rien et ne change aucune réponse. Elle sert uniquement à voir le nombre d'appels de votre projet sur 7 et 30 jours, endpoint par endpoint, sur la page Ma clé d'API.
Avec une clé de suivi (facultatif) : envoyez-la dans l'en-tête X-Api-Key de chaque requête.
$ curl -H "X-Api-Key: VOTRE_CLE" https://www.calendrier-tempo.fr/api/todaysensor:
- platform: rest
name: "Tempo couleur du jour"
resource: https://www.calendrier-tempo.fr/api/today
headers:
X-Api-Key: !secret calendrier_tempo_cle
value_template: "{{ value_json.couleur }}"
scan_interval: 3600Calendrier Tempo est un projet indépendant, fait par des clients Tempo, gratuit et sans publicité. Si le site vous est utile, un café nous aide à l'améliorer encore. Offrir un café (nouvel onglet)
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.