{"openapi":"3.0.3","info":{"title":"Balisio Public API","version":"1.0.0","description":"API publique de Balisio · lecture des consultations et de l'observatoire citoyen, et dépôt de contributions. CORS ouvert, sans clé pour la lecture. Données publiques et modérées uniquement.","contact":{"email":"mathurin.souetre@balisio.com"}},"servers":[{"url":"https://api.balisio.com"}],"paths":{"/api/v1/public/consultations":{"get":{"summary":"Lister les consultations publiques","parameters":[{"name":"commune","in":"query","schema":{"type":"string"},"description":"Code INSEE"},{"name":"status","in":"query","schema":{"type":"string","enum":["live","closed","archived"]}},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":200}},{"name":"offset","in":"query","schema":{"type":"integer","default":0}}],"responses":{"200":{"description":"Liste paginée"}}}},"/api/v1/public/consultations/{slug}":{"get":{"summary":"Détail d'une consultation","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Consultation"},"404":{"description":"Introuvable"}}}},"/api/v1/public/consultations/{slug}/questions":{"get":{"summary":"Schéma du questionnaire","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Questions"}}}},"/api/v1/public/consultations/{slug}/avis":{"get":{"summary":"Avis publiés","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer"}},{"name":"offset","in":"query","schema":{"type":"integer"}}],"responses":{"200":{"description":"Liste paginée d'avis"}}}},"/api/v1/public/consultations/{slug}/shapes":{"get":{"summary":"Périmètre / tracés (GeoJSON)","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"FeatureCollection GeoJSON"}}}},"/api/v1/public/consultations/{slug}/results":{"get":{"summary":"Résultats agrégés","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Agrégats"}}}},"/api/v1/public/consultations/{slug}/avis ":{},"/api/v1/public/observatoire/pins":{"get":{"summary":"Lister les signalements publiés","parameters":[{"name":"commune","in":"query","schema":{"type":"string"},"description":"Code INSEE"},{"name":"theme","in":"query","schema":{"type":"string"}},{"name":"status","in":"query","schema":{"type":"string"}},{"name":"bbox","in":"query","schema":{"type":"string"},"description":"ouest,sud,est,nord"},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":200}},{"name":"offset","in":"query","schema":{"type":"integer","default":0}}],"responses":{"200":{"description":"Liste paginée"}}}},"/api/v1/public/observatoire/pins/{id}":{"get":{"summary":"Détail d'un signalement","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Signalement"},"404":{"description":"Introuvable"}}}},"/api/v1/public/observatoire/themes":{"get":{"summary":"Catalogue des thèmes","responses":{"200":{"description":"Thèmes"}}}},"/api/v1/public/observatoire/stats":{"get":{"summary":"Statistiques agrégées","parameters":[{"name":"commune","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Agrégats"}}}},"/api/v1/public/observatoire/signalements":{"post":{"summary":"Déposer un signalement (modéré)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string"},"lat":{"type":"number"},"lon":{"type":"number"},"theme":{"type":"string"},"consent":{"type":"boolean"},"pseudonym":{"type":"string"},"contact_email":{"type":"string"}}}}}},"responses":{"201":{"description":"Publié"},"202":{"description":"En file de modération"},"429":{"description":"Trop de requêtes"}}}},"/api/v1/public/consultations/{slug}/avis_post":{"post":{"summary":"Déposer un avis (modéré)","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string"},"lat":{"type":"number"},"lon":{"type":"number"},"consent":{"type":"boolean"},"answers":{"type":"object"}}}}}},"responses":{"201":{"description":"Publié"},"202":{"description":"En file"}}}}}}