API Tempo EDF gratuite (JSON, sans clé)

Name: Couleurs Tempo EDF et prévisions (JSON)
Creator: Calendrier Tempo EDF

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.

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 et le repère « toujours bleu »	5 min

Les couleurs officielles sont les couleurs publiées par EDF, relayées par api-couleur-tempo.fr (service tiers qui diffuse les données Tempo EDF/RTE) ; seule la couleur publiée par EDF fait foi.

/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" et un message. EDF publie la couleur Tempo du lendemain chaque jour en fin de matinée, généralement vers 11 h.

$ curl https://www.calendrier-tempo.fr/api/today
{"status": "ok", "date": "AAAA-MM-JJ", "couleur": "BLEU", "code": 1}

/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, accuracy. 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

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.