Pour les machines

OpenAPI

La description complète de l'API, au format OpenAPI 3.1 : https://api.cavaparlement.eu/v1/openapi.json. Elle se charge dans Postman, Insomnia ou tout générateur de client.

Conventions

• Encodage UTF-8, JSON uniquement, dates au format ISO AAAA-MM-JJ.
• Noms de champs et valeurs en minuscules sans accent (arrivee, assemblee).
• L'id d'un mouvement est stable : il sert à dédoublonner entre deux synchronisations.
• Les versions sont préfixées (/v1) ; un changement incompatible donnera une /v2, annoncée à l'avance.
• CORS ouvert, mais ne mets jamais ta clé dans du code exécuté par un navigateur : passe par ton serveur.

Synchroniser proprement

1. Chaque jour, appelle /v1/mouvements?source=suivi&depuis=<hier>.
2. Insère les résultats en ignorant les id déjà connus.
3. Espace tes appels : un passage quotidien suffit, les données changent une fois par jour.