{"openapi":"3.0.0","info":{"title":"API d'acc\u00e8s aux donn\u00e9es tarifaires Tempo EDF","description":"Cette API donne un acc\u00e8s facile aux codes couleurs tarifaires de l'offre d'\u00e9lectricit\u00e9 Tempo en France, commercialis\u00e9e par EDF (tarif r\u00e9glement\u00e9, option Tempo). L'API fournit le code couleur du jour et du lendemain, les tarifs TTC de l'\u00e9lectricit\u00e9 au Kwh, ainsi que l'historique des couleurs depuis 2020.","version":"1.0.0"},"servers":[{"url":"\/","description":""}],"paths":{"\/api\/24h":{"get":{"operationId":"24h","tags":["TempsReel"],"responses":{"200":{"description":"TempsReel collection","content":{"application\/json":{"schema":{"type":"array","items":{"$ref":"#\/components\/schemas\/TempsReel"}}},"text\/html":{"schema":{"type":"array","items":{"$ref":"#\/components\/schemas\/TempsReel"}}}}}},"summary":"Retourne les donn\u00e9es de couleurs et tarifs sur 24 heures glissantes.","description":"Cette m\u00e9thode retourne un tableau de 24 objets TempsReel. La premi\u00e8re donn\u00e9e correspond \u00e0 l'heure actuelle (identique \u00e0 \/api\/now).\n\nLa logique Tempo est appliqu\u00e9e: le jour Tempo commence \u00e0 6h et se termine \u00e0 6h le lendemain.\n\nSi la couleur d'une heure n'est pas encore connue (typiquement pour les heures du lendemain apr\u00e8s-midi), la valeur contiendra des donn\u00e9es par d\u00e9faut conform\u00e9ment \u00e0 la description de l'objet TempsReel.\n\nCliquez sur 'Try it out' pour exp\u00e9rimenter et obtenir le code correspondant.","parameters":[],"deprecated":false},"parameters":[]},"\/api\/jourTempo\/today":{"get":{"operationId":"getToday","tags":["JourTempo"],"responses":{"200":{"description":"JourTempo resource","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/JourTempo"}},"text\/html":{"schema":{"$ref":"#\/components\/schemas\/JourTempo"}}}},"404":{"description":"Resource not found"}},"summary":"Retourne les informations Tempo pour aujourd'hui.","description":"Cette m\u00e9thode ne n\u00e9cessite aucun param\u00e8tre et renvoie simplement les donn\u00e9es pour aujourd'hui (couleur tarifaire valable de 6h du matin jusqu'\u00e0 6h demain matin).\n\nCliquez sur 'Try it out' pour exp\u00e9rimenter et obtenir le code correspondant.","parameters":[],"deprecated":false},"parameters":[]},"\/api\/jourTempo\/tomorrow":{"get":{"operationId":"getTomorrow","tags":["JourTempo"],"responses":{"200":{"description":"JourTempo resource","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/JourTempo"}},"text\/html":{"schema":{"$ref":"#\/components\/schemas\/JourTempo"}}}},"404":{"description":"Resource not found"}},"summary":"Retourne les informations Tempo pour demain.","description":"Cette m\u00e9thode ne n\u00e9cessite aucun param\u00e8tre et renvoie simplement les donn\u00e9es pour demain (couleur tarifaire valable \u00e0 partir de demain matin \u00e0 6h).\n\nNotez que les donn\u00e9e du lendemain sont susceptibles de ne pas \u00eatre encore disponible (code jour \u00e0 0); elles peuvent \u00e9galement ne pas \u00eatre d\u00e9finitives (changement possible jusqu'\u00e0 12h environ).\n\nCliquez sur 'Try it out' pour exp\u00e9rimenter et obtenir le code correspondant.","parameters":[],"deprecated":false},"parameters":[]},"\/api\/jourTempo\/yesterday":{"get":{"operationId":"getYesterday","tags":["JourTempo"],"responses":{"200":{"description":"JourTempo resource","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/JourTempo"}},"text\/html":{"schema":{"$ref":"#\/components\/schemas\/JourTempo"}}}},"404":{"description":"Resource not found"}},"summary":"Retourne les informations Tempo pour hier.","description":"Cette m\u00e9thode ne n\u00e9cessite aucun param\u00e8tre et renvoie simplement les donn\u00e9es de la veille, \u00e0 titre d'information (couleur tarifaire valable jusqu'\u00e0 6h ce matin).\n\nCliquez sur 'Try it out' pour exp\u00e9rimenter et obtenir le code correspondant.","parameters":[],"deprecated":false},"parameters":[]},"\/api\/jourTempo\/{dateJour}":{"get":{"operationId":"api_jourTempo_dateJour_get","tags":["JourTempo"],"responses":{"200":{"description":"JourTempo resource","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/JourTempo"}},"text\/html":{"schema":{"$ref":"#\/components\/schemas\/JourTempo"}}}},"404":{"description":"Resource not found"}},"summary":"Retourne les informations Tempo d'une date donn\u00e9e.","description":"Sp\u00e9cifiez simplement la date souhait\u00e9e au format AAAA-MM-JJ. Le r\u00e9sultat indique la couleur tarifaire applicable \u00e0 partir de 6h du matin le jour indiqu\u00e9, jusqu'\u00e0 6h le lendemain.\n\nNotez que les donn\u00e9e du lendemain sont susceptibles de ne pas \u00eatre encore disponible (code jour \u00e0 0); elles peuvent \u00e9galement ne pas \u00eatre d\u00e9finitives (changement possible jusqu'\u00e0 12h environ).\n\nCliquez sur 'Try it out' pour exp\u00e9rimenter et obtenir le code correspondant.","parameters":[{"name":"dateJour","in":"path","description":"JourTempo identifier","required":true,"deprecated":false,"allowEmptyValue":false,"schema":{"type":"string"},"style":"simple","explode":false,"allowReserved":false}],"deprecated":false},"parameters":[]},"\/api\/joursTempo":{"get":{"operationId":"api_joursTempo_get_collection","tags":["JourTempo"],"responses":{"200":{"description":"JourTempo collection","content":{"application\/json":{"schema":{"type":"array","items":{"$ref":"#\/components\/schemas\/JourTempo"}}},"text\/html":{"schema":{"type":"array","items":{"$ref":"#\/components\/schemas\/JourTempo"}}}}}},"summary":"Retourne les informations d'un ou plusieurs jours selon les crit\u00e8res de filtrages fournis.","description":"Cette m\u00e9thode plus complexe permet de r\u00e9cup\u00e9rer les informations de plusieurs jours en une seule requ\u00eate.\n\nSp\u00e9cifiez les crit\u00e8res de recherche, par exemple une date ou un ensemble de dates, afin d'obtenir les informations correspondantes.\n\nLes donn\u00e9es sont retourn\u00e9es dans l'ordre chronologique.\n\nCliquez sur 'Try it out' pour exp\u00e9rimenter et obtenir le code correspondant.","parameters":[{"name":"dateJour","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false},{"name":"dateJour[]","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"array","items":{"type":"string"}},"style":"form","explode":true,"allowReserved":false},{"name":"codeJour","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"integer"},"style":"form","explode":false,"allowReserved":false},{"name":"codeJour[]","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"array","items":{"type":"integer"}},"style":"form","explode":true,"allowReserved":false},{"name":"periode","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false},{"name":"periode[]","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"array","items":{"type":"string"}},"style":"form","explode":true,"allowReserved":false}],"deprecated":false},"parameters":[]},"\/api\/now":{"get":{"operationId":"now","tags":["TempsReel"],"responses":{"200":{"description":"TempsReel resource","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/TempsReel"}},"text\/html":{"schema":{"$ref":"#\/components\/schemas\/TempsReel"}}}},"404":{"description":"Resource not found"}},"summary":"Retourne le tarif applicable actuellement.","description":"Cette m\u00e9thode ne n\u00e9cessite aucun param\u00e8tre et renvoie simplement les donn\u00e9es tarifaires actuelles.\n\nCette m\u00e9thode tient compte de l'heure d'appel (s'il est moins de 6h du matin, le tarif de la veille est renvoy\u00e9).\n\nCliquez sur 'Try it out' pour exp\u00e9rimenter et obtenir le code correspondant.","parameters":[],"deprecated":false},"parameters":[]},"\/api\/stats":{"get":{"operationId":"getStats","tags":["Statistiques"],"responses":{"200":{"description":"Statistiques resource","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Statistiques"}},"text\/html":{"schema":{"$ref":"#\/components\/schemas\/Statistiques"}}}},"404":{"description":"Resource not found"}},"summary":"Retourne les informations statistiques sur la p\u00e9riode Tempo en cours (jours consomm\u00e9s et restants pour chaque couleur).","description":"Cette m\u00e9thode ne n\u00e9cessite aucun param\u00e8tre et renvoie simplement les donn\u00e9es statistiques.\n\nLa date courante est incluse dans les statistiques de jours consomm\u00e9s d\u00e8s 0h00. En revanche, le lendemain n'est jamais inclus, m\u00eame lorsque sa couleur est d\u00e9j\u00e0 connue.\n\nCliquez sur 'Try it out' pour exp\u00e9rimenter et obtenir le code correspondant.","parameters":[],"deprecated":false},"parameters":[]},"\/api\/tarifs":{"get":{"operationId":"getTarifs","tags":["Tarification"],"responses":{"200":{"description":"Tarification resource","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Tarification"}},"text\/html":{"schema":{"$ref":"#\/components\/schemas\/Tarification"}}}},"404":{"description":"Resource not found"}},"summary":"Retourne les tarifs actuels de l'offre Tempo (prix au Kwh). Le prix des abonnements varie selon la puissance soucrite, il n'est pas fourni par cette API.","description":"Cette m\u00e9thode ne n\u00e9cessite aucun param\u00e8tre et renvoie simplement les donn\u00e9es tarifaires.\n\nCliquez sur 'Try it out' pour exp\u00e9rimenter et obtenir le code correspondant.","parameters":[],"deprecated":false},"parameters":[]}},"components":{"schemas":{"JourTempo":{"type":"object","description":"Repr\u00e9sente une journ\u00e9e du calendrier tarifaire Tempo.","deprecated":false,"properties":{"dateJour":{"type":"string","format":"date","example":"2024-11-08","description":"Date du jour concern\u00e9 par l'information. La date est au format SQL (AAAA-MM-JJ)."},"codeJour":{"description":"Code couleur du tarif Tempo applicable. Il s'agit de la couleur tarifaire applicable \u00e0 partir de 6h du matin du jour indiqu\u00e9, jusqu'au lendemain \u00e0 6h. Valeurs possibles:\n- 0: tarif inconnu (pas encore communiqu\u00e9 par RTE)\n- 1: tarif bleu\n- 2: tarif blanc\n- 3: tarif rouge","type":"integer"},"periode":{"type":"string","example":"2025-2026","description":"La p\u00e9riode est l'ann\u00e9e Tempo \u00e0 laquelle ce jour appartient. Les p\u00e9riodes vont du 1er septembre au 31 ao\u00fbt. La p\u00e9riode est retourn\u00e9e au format AAAA-AAAA, par exemple '2023-2024'."},"libCouleur":{"type":"string","example":"Bleu","readOnly":true,"description":"Libell\u00e9 de la couleur en toutes lettres, parmi Inconnu, Bleu, Blanc, Rouge."}}},"Statistiques":{"type":"object","description":"Donn\u00e9es statistiques sur la p\u00e9riode Tempo en cours (01\/09 -> 31\/08).","deprecated":false,"properties":{"periode":{"type":"string","example":"2025-2026","description":"La p\u00e9riode est l'ann\u00e9e Tempo concern\u00e9e par ces statistiques. Les p\u00e9riodes vont du 1er septembre au 31 ao\u00fbt. La p\u00e9riode est retourn\u00e9e au format AAAA-AAAA, par exemple '2023-2024'."},"bissextile":{"type":"bool","example":false,"description":"Indique si la p\u00e9riode est bissextile. Les p\u00e9riodes bissextiles ont un jour bleu suppl\u00e9mentaire."},"dernierJourInclus":{"type":"string","example":"2025-08-23","description":"Derni\u00e8re date incluse dans les statistiques des jours consomm\u00e9s. Il s'agit de la date courante, au format AAAA-MM-JJ."},"joursBleusConsommes":{"description":"Nombre total de jours Bleus consomm\u00e9s dans la p\u00e9riode, depuis le 1er septembre et jusqu'au dernier jour inclus.","type":"integer"},"joursBlancsConsommes":{"description":"Nombre total de jours Blancs consomm\u00e9s dans la p\u00e9riode, depuis le 1er septembre et jusqu'au dernier jour inclus.","type":"integer"},"joursRougesConsommes":{"description":"Nombre total de jours Rouges consomm\u00e9s dans la p\u00e9riode, depuis le 1er septembre et jusqu'au dernier jour inclus.","type":"integer"},"joursBleusRestants":{"description":"Nombre total de jours Bleus restants dans la p\u00e9riode, \u00e0 partir du lendemain et jusqu'au 31\/08.","type":"integer"},"joursBlancsRestants":{"description":"Nombre total de jours Blancs restants dans la p\u00e9riode, \u00e0 partir du lendemain et jusqu'au 31\/08.","type":"integer"},"joursRougesRestants":{"description":"Nombre total de jours Rouges restants dans la p\u00e9riode, \u00e0 partir du lendemain et jusqu'au 31\/08.","type":"integer"}}},"Tarification":{"type":"object","description":"Contient la grille tarifaire actuelle de l'option Tempo, hors abonnement.\nLes tarifs sont TTC.","deprecated":false,"properties":{"bleuHC":{"description":"Tarif TTC du kWh en heures creuses, jour bleu","type":"number"},"bleuHP":{"description":"Tarif TTC du kWh en heures pleines, jour bleu","type":"number"},"blancHC":{"description":"Tarif TTC du kWh en heures creuses, jour blanc","type":"number"},"blancHP":{"description":"Tarif TTC du kWh en heures pleines, jour blanc","type":"number"},"rougeHC":{"description":"Tarif TTC du kWh en heures creuses, jour rouge","type":"number"},"rougeHP":{"description":"Tarif TTC du kWh en heures pleines, jour rouge","type":"number"},"dataGouvId":{"description":"Identifiant du tarif sur l'API gouvernementale (https:\/\/tabular-api.data.gouv.fr\/api\/resources\/0c3d1d36-c412-4620-8566-e5cbb4fa2b5a\/data\/).","type":"integer"},"tarifForce":{"description":"Indique si le tarif a \u00e9t\u00e9 forc\u00e9 cot\u00e9 API, c'est-\u00e0-dire s'il a \u00e9t\u00e9 modifi\u00e9 manuellement.","type":"boolean"},"dateDebut":{"type":"string","format":"date","example":"2025-08-01","description":"Date de d\u00e9but des tarifs actuels."}}},"TempsReel":{"type":"object","description":"Repr\u00e9sente les donn\u00e9es tarifaires applicables \u00e0 un instant donn\u00e9.","deprecated":false,"properties":{"applicableIn":{"description":"Indique \u00e0 quoi correspond cette donn\u00e9e horaire. Valeurs possibles:\n- 0: donn\u00e9e pour l'heure en cours (de l'appel)\n- 1: donn\u00e9e pour l'heure suivante\n- 2: donn\u00e9e pour l'heure d'apr\u00e8s\n- etc jusqu'\u00e0 23 (donn\u00e9e pour l'heure 23 heures apr\u00e8s l'appel)","type":"integer"},"codeCouleur":{"description":"Code couleur du tarif Tempo applicable. Il s'agit de la couleur tarifaire applicable. Valeurs possibles:\n- 0: tarif inconnu (ne devrait pas arriver dans le cadre d'un appel sur \/now sauf en cas d'erreur de remont\u00e9e de l'information officielle)\n- 1: tarif bleu\n- 2: tarif blanc\n- 3: tarif rouge","type":"integer"},"codeHoraire":{"description":"Code indiquant si le tarif est en heures pleines ou en heures creuses. Valeurs possibles:\n- 0: heures creuses\n- 1: heures pleines","type":"integer"},"tarifKwh":{"description":"Tarif du Kwh en euros TTC. 0 en cas d'erreur d'obtention du tarif.","type":"number"},"libTarif":{"description":"Libell\u00e9 du tarif applicable, pour affichage. Le libell\u00e9 est une de ces chaines:\n- \"Bleu-HC\"\n- \"Bleu-HP\"\n- \"Blanc-HC\"\n- \"Blanc-HP\"\n- \"Rouge-HC\"\n- \"Rouge-HP\"\n- \"Inconnu-HP\" ou \"Inconnu-HC\" si l'information n'est pas disponible.","type":"string"}}}},"responses":{},"parameters":{},"examples":{},"requestBodies":{},"headers":{},"securitySchemes":{}},"security":[],"tags":[]}