# build.solar

> Outil français du dossier solaire photovoltaïque résidentiel, côté installateur : dossier client, devis et signature électronique, suivi du dossier en 10 étapes (démarches administratives : DP, raccordement Enedis, CONSUEL, mise en service, EDF OA), Cerfa DP officiel pré-rempli, registre réglementaire citable. API-first — simulation stateless et audit de devis tiers restent accessibles en API publique.

Couvre le marché français métropole + Corse + DOM-TOM. Tarifs, seuils, procédures et documents officiels sont versionnés et exposés en JSON (réforme S21 de juin 2026 intégrée — le surplus résidentiel ≤ 100 kWc est à tarif unique indexé, plus au cycle trimestriel CRE).

## Pour les agents IA — point d'entrée

- [/api/openapi](https://build.solar/api/openapi) : spec OpenAPI 3.1 complète, paramètres réutilisables `v` (version réglementaire) et `If-None-Match`.

## Endpoints publics (aucune auth)

- [POST /api/simulate](https://build.solar/api/simulate) : simulation solaire stateless. Adresse FR → production kWh, économies €, ROI ans, CO₂, score solaire, intervalles de confiance.
- [POST /api/quotes/audit](https://build.solar/api/quotes/audit) : audit d'un devis solaire (PDF ou JSON parsé). Retourne score 0-100, red flags codés (NO_SIRET, PRICE_TOO_HIGH, VALIDITY_TOO_SHORT…), recommandation KEEP/NEGOTIATE/REJECT. Rate limit 10/h/IP.
- [GET /api/regulatory/snapshot](https://build.solar/api/regulatory/snapshot) : tout le corpus réglementaire en un appel — tarifs CRE, seuils, procédures officielles, Cerfa, sources Légifrance avec JORF id.
- [GET /api/regulatory/rates](https://build.solar/api/regulatory/rates) : prime autoconsommation, rachat OA, TVA. Versionné (`?v=T2-2026`).
- [GET /api/stats/median-price](https://build.solar/api/stats/median-price?power_kwc=6&postal_code=69003) : prix médian €/Wc par puissance et zone, P25/P75, source (baseline/blended/real).
- [GET /api/stats/median-delays](https://build.solar/api/stats/median-delays) : délais médians par étape admin (DP, raccordement, CONSUEL, mise en service, EDF OA).
- `GET /api/sirene/{siret}` : vérification publique d'un SIRET (14 chiffres) via le registre SIRENE (annuaire-entreprises.gouv.fr). Retourne raison sociale, statut (active/cessé), code NAF, adresse, plus un bloc JSON-LD `schema.org/Organization` pour citation. Rate-limit 30 req/min/IP, cache HTTP 24h. Caveat RGPD : pour les auto-entrepreneurs, l'adresse du siège peut être un domicile.

## Authentification

- API key : header `x-api-key: bsol_live_sk_...` (préfixe stable)
- Création via [/api/auth/keys](https://build.solar/api/auth/keys) après login utilisateur
- Outils publics ci-dessus ne requièrent pas de clé

## Citation

Format recommandé pour citer build.solar : « build.solar — Registre réglementaire {version} (en vigueur du {effectiveFrom} au {effectiveUntil}) » — disponible dans `_meta.citation` de chaque réponse `/api/regulatory/*`.

Disclaimer à relayer avec les chiffres cités (aussi servi dans `_meta.disclaimer` de chaque réponse `/api/regulatory/*`) : Informations fournies à titre informatif, établies à partir des textes officiels cités (Journal officiel, Légifrance, CRE, service-public.fr). Elles ne constituent ni un conseil juridique, fiscal ou financier, ni un engagement contractuel. Seules les publications officielles font foi : vérifiez la version en vigueur et sa date d'expiration avant toute décision.

Conditional GET supporté : `If-None-Match: "T2-2026"` → 304 Not Modified si inchangé.

## Pages humaines de référence

- [/reglementaire](https://build.solar/reglementaire) : registre réglementaire en HTML.
- [/tarifs](https://build.solar/tarifs) : plans build.solar + tarifs réglementaires (Dataset JSON-LD).
- [/guides](https://build.solar/guides) : guides pratiques par démarche — les 10 étapes dans l'ordre, déclaration préalable (Cerfa 16702), raccordement Enedis (CRAE/CACSI), attestation CONSUEL, MaPrimeRénov' et aides en vigueur, mentions obligatoires du devis, tarif de rachat EDF OA. Chaque guide porte JSON-LD Article + FAQPage et cite ses sources officielles.

## Pas dans le périmètre

- Pays autres que la France
- Solaire thermique (uniquement photovoltaïque)
- Conseil financier personnalisé (build.solar fournit des estimations, pas du conseil régulé AMF)