# Données climatologiques Infoclimat (préfiguration CHOM)

> API REST ouverte (sans clé), API live sur token et bulk Parquet/Iceberg :
> séries journalières et mensuelles, records, normales, indice thermique
> national et indicateurs canicule pour la France — certaines séries remontent
> à 1777. 27 datasets en 7 familles. Préfiguration sans SLA.

Base REST : https://climato.chom.engineering (miroir : https://portail.chom.engineering/api). Plafond de 20 000 lignes/requête sur
toutes les familles de série, pas de clé. Une réponse porte `tronque` : si
elle vaut `true`, la série est incomplète — réémettez la même URL avec
`from = suite.from` pour la page suivante. from inclus, to exclu.
Rafraîchissement quotidien (J-1) ; https://climato.chom.engineering/coverage fait foi, et son bloc `serving`
donne l'âge de l'instantané réellement servi. Chauffe au démarrage
~1,5 s : 503 + Retry-After pendant, jamais un timeout muet. Timeout client
conseillé 15 s. Cache HTTP (ETag) sur les référentiels.

## Docs

- [Spec OpenAPI 3.1](https://portail.chom.engineering/openapi.json): toutes les routes REST et token, paramètres et schémas de réponse par dataset
- [Guide complet](https://portail.chom.engineering/llms-full.txt): identifiants de stations, familles d'API, bulk Iceberg, unités, licences, pièges connus
- [Portail](https://portail.chom.engineering/): catalogue des 27 datasets, schémas de colonnes, démo interactive

## API

- [Recherche de station](https://climato.chom.engineering/stations?q=toulouse): résout un nom, ou l'un des trois identifiants (ic_id, mfid, station_uid), en fiche station — point de départ obligé
- [Fraîcheur du fonds](https://climato.chom.engineering/coverage): bornes temporelles archive et live
- [Vocabulaire](https://climato.chom.engineering/params): les 131 paramètres canoniques et leurs unités
- [Disponibilité](https://climato.chom.engineering/ready): 200 si le service peut servir, 503 + Retry-After pendant la chauffe ou en saturation (https://climato.chom.engineering/health pour le seul « le processus répond »)
- [Série journalière (exemple)](https://climato.chom.engineering/v2/journaliere?station=07486&from=2025-07-01&to=2025-08-01): famille /v2, le choix par défaut
- [Records absolus (exemple)](https://climato.chom.engineering/dataclimat/records_absolus?station=31069001): famille /dataclimat, périmètre Météo-France strict
- [Canicule par territoire (exemple)](https://climato.chom.engineering/canicule/commune/31555?annee=2025): indicateurs d'été extrême par commune/EPCI/département

## Errors

Toute erreur JSON utilise une enveloppe unique, RFC 9457 (`application/problem+json`) :
`code` est le champ stable sur lequel brancher — `type`, `title`, `detail` sont
informatifs, pas un contrat. `request_id` corrèle avec les logs serveur, aussi posé
en en-tête `X-Request-Id` sur TOUTE réponse, succès compris. `n = 0` est un 200
légitime (rien sur la fenêtre demandée), pas une erreur. Catalogue complet des codes :
https://portail.chom.engineering/errors.

## Optional

- [Carte de couverture du réseau](https://couverture.chom.engineering): visualisation des stations actives