{"openapi":"3.1.0","info":{"title":"Copropriétés Paris API","version":"1.0.0","description":"Copropriétés (RNIC) et chantiers en cours à Paris. Lecture seule, sans clé, CORS ouvert. Merci de citer la source et de mettre en cache.","license":{"name":"Licence Ouverte 2.0 / ODbL selon la source"}},"servers":[{"url":"https://coproprietes-paris.fr"}],"paths":{"/api/v1/coproprietes":{"get":{"summary":"Rechercher des copropriétés","description":"Un des modes : lat+lon (proximité), q (texte : adresse ou nom), arrondissement (liste paginée).","parameters":[{"name":"lat","in":"query","schema":{"type":"number"},"description":"Latitude WGS84"},{"name":"lon","in":"query","schema":{"type":"number"},"description":"Longitude WGS84"},{"name":"radius","in":"query","schema":{"type":"integer","default":300,"minimum":10,"maximum":2000},"description":"Rayon en mètres"},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":200}},{"name":"q","in":"query","schema":{"type":"string","minLength":3}},{"name":"arrondissement","in":"query","schema":{"type":"string","enum":["75001","75002","75003","75004","75005","75006","75007","75008","75009","75010","75011","75012","75013","75014","75015","75016","75017","75018","75019","75020"]}},{"name":"page","in":"query","schema":{"type":"integer","default":1}}],"responses":{"200":{"description":"Liste","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CoproList"}}}},"400":{"$ref":"#/components/responses/Error"}}}},"/api/v1/coproprietes/{id}":{"get":{"summary":"Fiche d'une copropriété","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Numéro d'immatriculation RNIC (ex. AA1234567)"}],"responses":{"200":{"description":"Fiche + chantiers à 300 m","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Copro"}}}},"404":{"$ref":"#/components/responses/Error"}}}},"/api/v1/chantiers":{"get":{"summary":"Chantiers en cours","description":"lat+lon pour une recherche de proximité, sinon liste paginée (40 par page), filtrable par arrondissement et catégorie.","parameters":[{"name":"lat","in":"query","schema":{"type":"number"},"description":"Latitude WGS84"},{"name":"lon","in":"query","schema":{"type":"number"},"description":"Longitude WGS84"},{"name":"radius","in":"query","schema":{"type":"integer","default":300,"minimum":10,"maximum":2000},"description":"Rayon en mètres"},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":200}},{"name":"arrondissement","in":"query","schema":{"type":"string","enum":["75001","75002","75003","75004","75005","75006","75007","75008","75009","75010","75011","75012","75013","75014","75015","75016","75017","75018","75019","75020"]}},{"name":"categorie","in":"query","schema":{"type":"string"}},{"name":"page","in":"query","schema":{"type":"integer","default":1}},{"name":"format","in":"query","schema":{"type":"string","enum":["json","geojson"],"default":"json"}}],"responses":{"200":{"description":"Liste ou FeatureCollection GeoJSON","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChantierList"}},"application/geo+json":{}}}}}}},"components":{"responses":{"Error":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}},"schemas":{"CoproLite":{"type":"object","properties":{"id":{"type":"string"},"slug":{"type":"string"},"nom":{"type":["string","null"]},"adresse":{"type":"string"},"code_postal":{"type":["string","null"]},"arrondissement":{"type":["string","null"]},"lat":{"type":["number","null"]},"lon":{"type":["number","null"]},"nb_lots":{"type":["integer","null"]},"nb_lots_habitation":{"type":["integer","null"]},"periode_construction":{"type":["string","null"]},"type_syndic":{"type":["string","null"]},"distance_m":{"type":"number"},"url":{"type":"string","format":"uri"}}},"Copro":{"allOf":[{"$ref":"#/components/schemas/CoproLite"},{"type":"object","properties":{"syndic_raison_sociale":{"type":["string","null"]},"mandat_statut":{"type":["string","null"]},"date_immatriculation":{"type":["string","null"],"format":"date"},"date_reglement":{"type":["string","null"],"format":"date"},"cadastre":{"type":["string","null"]},"chantiers_300m":{"type":"array","items":{"$ref":"#/components/schemas/Chantier"}}}}]},"CoproList":{"type":"object","properties":{"city":{"type":"string"},"count":{"type":"integer"},"total":{"type":"integer"},"items":{"type":"array","items":{"$ref":"#/components/schemas/CoproLite"}}}},"Chantier":{"type":"object","properties":{"id":{"type":"string"},"arrondissement":{"type":["string","null"]},"categorie":{"type":["string","null"]},"synthese":{"type":["string","null"]},"maitre_ouvrage":{"type":["string","null"]},"date_debut":{"type":["string","null"],"format":"date"},"date_fin":{"type":["string","null"],"format":"date"},"surface":{"type":["number","null"]},"localisation":{"type":["array","null"],"items":{"type":"string"}},"lat":{"type":"number"},"lon":{"type":"number"},"first_seen_at":{"type":"string","format":"date-time"},"distance_m":{"type":"number"}}},"ChantierList":{"type":"object","properties":{"city":{"type":"string"},"count":{"type":"integer"},"total":{"type":"integer"},"items":{"type":"array","items":{"$ref":"#/components/schemas/Chantier"}}}}}}}