Données ouvertes
Version v1. Les champs publiés ne sont ni retirés ni renommés. Ajouter un champ n'est pas une rupture. Une version incompatible s'appellera v2, sans retirer v1.
Licence
Le document territoire est sous Licence Ouverte 2.0. Attribution : « Transpareo », plus le producteur indiqué sur chaque série (ANIL, DVF, INSEE, ADEME, Géorisques, data.gouv.fr). Les géométries OpenStreetMap et les données Navitia ne sont pas dans ce fichier. Les avis ne le sont pas non plus.
La couverture des avis est une autre adresse, tous droits réservés : seulement le nombre d'avis, à partir de 20. Pas de note, pas de texte, pas de bailleur.
Clé
kind + code (code INSEE ou équivalent). Le slug n'est pas une clé : sa résolution dépend de l'entrepôt, qui n'est pas lu en production.
Exemples
curl -sS -H "X-Transpareo-Reuse: exemple@organisation.fr" \ "https://transpareo.fr/api/v1/territoires/commune/75056" curl -sS "https://transpareo.fr/api/v1/territoires/commune/75056/couverture"
L'en-tête X-Transpareo-Reuse est facultatif. Il sert à savoir qui réutilise, pas à autoriser l'accès. Limite : 120 requêtes par minute et par adresse, pour absorber les abus, pas pour fermer la réutilisation.
L'indice publié est recalculé sans la dimension « satisfaction des résidents ». Si les dimensions manquent, aucun chiffre d'indice n'est renvoyé. Le taux d'encadrement est celui de l'agglomération, pas de la commune seule, et il est omis sous le seuil ou si le dispositif est terminé.