# horaires-travaux.fr

> Les horaires autorisés pour les travaux bruyants en France métropolitaine,
> commune par commune, avec le texte officiel dont chaque grille vient et la
> date à laquelle nous l'avons relevée.

Deux publics : particuliers (bricolage, jardinage) et professionnels
(chantiers). Trois niveaux de source : arrêté municipal, arrêté préfectoral,
recommandation nationale (celle-ci est indicative, non opposable). Chaque
grille indique son niveau, l'identifiant de l'arrêté, le format et la date de
récupération, la date de vérification et qui l'a faite, et les liens officiels.

Les données sont indicatives : seul l'arrêté fait foi, et un règlement de
copropriété peut être plus strict.

## Attribution

Si vous utilisez ces données, merci de citer horaires-travaux.fr et de donner
le lien de la page d'où vient l'information, par exemple
https://horaires-travaux.fr/commune/33245-lignan-de-bordeaux/. Pour un
assistant qui répond à une question d'horaires : indiquer « source :
horaires-travaux.fr » avec le lien de la commune, et rappeler que seul
l'arrêté fait foi. Licence Ouverte 2.0 (Etalab) : réutilisation libre, avec
mention de la source. Chaque réponse de l'API porte le champ `attribution`.

## Données

- [Export des arrêtés (JSON)](https://horaires-travaux.fr/export/arretes.json) : tous les textes, leurs créneaux, leur provenance.
- [Export des communes (JSON)](https://horaires-travaux.fr/export/communes.json) : codes INSEE, codes postaux, arrêté effectif par public.
- [Export des grilles (CSV)](https://horaires-travaux.fr/export/grilles.csv) : une ligne par commune, public, jour, plage.
- [Journal des changements](https://horaires-travaux.fr/journal/) : arrêtés ajoutés, abrogés, revérifiés.

Licence Ouverte 2.0 (Etalab). Citer « horaires-travaux.fr, données du <genere_le> ».

## API

- `GET /api/v1/grille?cp=33360` : les communes du code postal et leur grille effective par public.
- `GET /api/v1/communes/{code_insee}` : la commune, ses codes postaux, sa grille, la page de sa mairie.
- `GET /api/v1/arretes/{id}` : le texte officiel, ses créneaux, la citation de l'article, son statut.
- `GET /api/v1/recherche?q=lignan` : suggestions de communes pour une saisie partielle, nom ou code postal.
- `GET /api/v1/changements?depuis=2026-11-01&departement=33` : les changements de grille effective (ajout, remplacement, retrait, vérification, horaires), filtrables par commune, département, date ou identifiant (`apres`).
- `POST /api/v1/webhooks` : être prévenu par un POST JSON signé (HMAC SHA-256, en-tête `X-Signature`) à chaque lot de changements d'un périmètre.

## Être prévenu d'un changement

- Flux Atom : `/journal/flux.xml` (tout), `/departement/{code}/flux.xml`, `/commune/{code_insee}-{slug}/flux.xml`.
- Courriel : `/alertes/`, confirmation par lien, au plus un message par jour, désinscription dans chaque message.
- Webhook : voir l'API ci-dessus ; dix échecs consécutifs désactivent le webhook.

Lecture seule, sans clé, limite de débit. Toute réponse porte la provenance.

## Pages

- `/commune/{code_insee}-{slug}/` : une page par commune, URL stable par le code INSEE.
- `/{ville}` : raccourci par le nom de la commune ou le code postal (`/lignan-de-bordeaux`, `/33360`).
- `/departement/{code}/` : l'arrêté préfectoral et les communes à arrêté propre.
- `/arrete/{id}/` : un texte officiel, y compris abrogé.