{"openapi":"3.0.1","info":{"title":"Solaire Efficace API","description":"Public read API for Solaire Efficace. Exposes sitemap, RSS, articles feed for AI consumption.","version":"1.0.0"},"servers":[{"url":"https://solaire-efficace.fr"}],"paths":{"/llms.txt":{"get":{"operationId":"getLlmsTxt","summary":"AI-readable site summary (Markdown)","responses":{"200":{"description":"OK"}}}},"/llms-full.txt":{"get":{"operationId":"getLlmsFullTxt","summary":"Full content dump for LLM training","responses":{"200":{"description":"OK"}}}},"/ai.txt":{"get":{"operationId":"getAiTxt","summary":"AI usage policy and site info","responses":{"200":{"description":"OK"}}}},"/sitemap.xml":{"get":{"operationId":"getSitemap","summary":"XML sitemap","responses":{"200":{"description":"OK"}}}},"/api/simulateur/solaire":{"get":{"operationId":"simulerSolaire","summary":"Simulateur solaire heure par heure : économie annuelle estimée pour une offre standard des installateurs, journée type, mois","description":"Même moteur que https://solaire-efficace.fr/simulateur (méthode : https://solaire-efficace.fr/simulateur/methode, version 2026-11-07). Production horaire PVGIS de la commune, profils Enedis, autoconsommation = min(production, consommation) à chaque heure, surplus à 1,1 c€/kWh HT, tarifs réglementés au 01/08/2026. Liste stricte de paramètres (un paramètre inconnu est refusé), 30 requêtes par minute au plus. Estimation indicative.","parameters":[{"name":"commune","in":"query","required":true,"description":"Commune, code postal (« 69001 ») ou « Nom (code postal) ».","schema":{"type":"string","maxLength":60}},{"name":"facture","in":"query","required":false,"description":"Facture d'électricité mensuelle en euros TTC (option Base) ; ou conso.","schema":{"type":"number","minimum":20,"maximum":1500}},{"name":"conso","in":"query","required":false,"description":"Consommation annuelle en kWh (prioritaire sur facture).","schema":{"type":"number","minimum":500,"maximum":50000}},{"name":"orientation","in":"query","required":false,"description":"Orientation du pan.","schema":{"type":"string","enum":["sud","sud-est","sud-ouest","est","ouest"],"default":"sud"}},{"name":"pente","in":"query","required":false,"description":"Pente du toit en degrés.","schema":{"type":"integer","enum":[0,15,30,45],"default":30}},{"name":"option","in":"query","required":false,"description":"Option tarifaire.","schema":{"type":"string","enum":["base","hc"],"default":"base"}},{"name":"kva","in":"query","required":false,"description":"Puissance souscrite.","schema":{"type":"integer","enum":[3,6,9,12,15,18,24,30,36],"default":6}},{"name":"hp","in":"query","required":false,"description":"Option hc : consommation annuelle en heures pleines (kWh).","schema":{"type":"number","minimum":100,"maximum":50000}},{"name":"hc","in":"query","required":false,"description":"Option hc : consommation annuelle en heures creuses (kWh).","schema":{"type":"number","minimum":100,"maximum":50000}},{"name":"puissance","in":"query","required":false,"description":"Offre à étudier en kWc, parmi les offres standard ; sinon l'offre retenue d'après la facture mensuelle (seuils dans parametres.seuils_facture_eur ; sans facture, celle qui correspond à la consommation). Toute autre valeur est refusée (422).","schema":{"type":"number","enum":[3,4.5,6,9]}}],"responses":{"200":{"description":"Estimation indicative. Résultat : version du référentiel, date des paramètres, date du calcul, phrase à citer, avertissement (à reproduire avec tout chiffre repris), preuve (version et date), conditions d'utilisation (phrase de réserve) et leur adresse, entrées, commune, consommation, tarif, paramètres (offres standard en kWc, seuils de facture mensuelle en euros), résultat (offre étudiée, son calcul, journée type d'été et d'hiver, mois, années météo), adresse du calcul PVGIS, sources."},"400":{"description":"Paramètre inconnu ou aucun paramètre."},"404":{"description":"Aucun simulateur solaire sur ce site."},"422":{"description":"Saisie invalide (message en français)."},"429":{"description":"Débit dépassé (30 par minute)."},"503":{"description":"Service public interrogé indisponible (communes ou PVGIS)."}}}}}}