# S33D

> Services publics et gratuits de S33D (France) : fiches des communes, des entreprises, prix des carburants, transports en commun, bornes de recharge, API pour développeurs. Les robots d'indexation et les agents IA sont les bienvenus. Cette notice dit ce qu'ils peuvent faire seuls.

## 1. Libre, sans clé, pour tout robot ou agent

- Lire toutes les pages publiques et les plans de site (`/sitemap.xml`) de chaque site *.s33d.fr.
- Interroger les API JSON de lecture ci-dessous. Réponses en JSON, en français.
- Débit : au plus 300 requêtes par 10 secondes et par adresse IP (au-delà : HTTP 429). Merci d'annoncer un User-Agent explicite et de rester bien en dessous pour un crawl.

### communes.s33d.fr : une fiche par commune de France
- `GET /api/recherche?q=<nom ou code postal>` : trouver une commune (code INSEE, population, URL de la fiche)
- `GET /api/commune/<insee>/resume` : résumé (population, surface, élus, immobilier, risques…)
- `GET /api/commune/<insee>` : fiche complète
- `GET /api/commune/<insee>/professionnels` : professionnels de santé et services

### entreprises.s33d.fr : une fiche par entreprise (SIREN) et établissement (SIRET)
- `GET /api/recherche?q=<nom, activité, ville>`
- `GET /api/entreprise/<siren>` · `GET /api/etablissement/<siret>` · `GET /api/voisins/<siren>`

### carburants.s33d.fr : prix des carburants, relus toutes les 10 minutes
- `GET /api/autour?lat=<lat>&lon=<lon>` : stations et prix autour d'un point
- `GET /api/communes/<insee>` · `GET /api/communes/<insee>/historique`

### transports.s33d.fr : prochains départs de chaque arrêt et gare
- `GET /api/proches?lat=<lat>&lon=<lon>` : arrêts proches
- `GET /api/recherche?q=<arrêt ou gare>` · `GET /api/arret/<slug>` · `GET /api/arret/<slug>/departs`
- `GET /api/ligne/<reseau>/<ligne>` · `GET /api/reseaux` · `GET /api/commune/<insee>/arrets`

### elec.s33d.fr : bornes de recharge, France et Europe
- `GET /api/autour?lat=<lat>&lon=<lon>` : bornes autour d'un point
- Documentation : https://elec.s33d.fr/docs (itinéraires limités à 40 calculs par 5 minutes)

### Autres pages publiques
- https://incidents.s33d.fr : état des services, flux Atom et JSON
- https://api.s33d.fr/docs : documentation de l'API S33D

## 2. Avec une clé gratuite, pour un agent qui agit au nom d'un humain

L'API S33D (recherche, outils IA, voix, musique…) demande une clé. Elle est gratuite, mais créée par un humain sur https://api.s33d.fr avec un mobile français vérifié (un numéro par compte). Quota : 200 appels par jour et par compte. En-tête : `Authorization: Bearer <clé>` ou `X-API-Key: <clé>`.

## 3. Réservé aux humains : ne pas automatiser

- Créer un compte, une boîte s33d.email, une clé API.
- Envoyer des e-mails ou des SMS, s'inscrire aux alertes d'une commune.
- Faire un don ou un paiement.
- Déposer une opposition sur entreprises.s33d.fr (procédure légale).
- Jouer des parties classées (échecs, dames, poker) : les classements sont réservés aux humains.

## Contact

admin@s33d.fr