Guide d'accès aux API de données ouvertes - Règlement municipal de Toronto
Toronto, Ontario tient un portail officiel de données ouvertes et des conditions de licence pour les ensembles de données municipaux. Ce guide explique comment accéder aux API de données ouvertes, ce que la Ville publie et comment les conditions d'utilisation et l'application peuvent s'appliquer lors de l'utilisation des ensembles de données de la Ville. Suivez les étapes ci-dessous pour trouver des ensembles de données, appeler des API et respecter les conditions d'utilisation de la Ville.[1]
Comment trouver et se connecter aux API de données ouvertes de Toronto
Toronto publie des ensembles de données et des points de terminaison API via son portail Open Data. Les méthodes d'accès typiques incluent des points de terminaison API directs pour les ensembles de données, des téléchargements CSV/GeoJSON et des clés API pour développeurs lorsque disponibles.
- Recherchez l'ensemble de données dans le catalogue Open Data de la Ville de Toronto.
- Ouvrez la page de l'ensemble de données pour voir les formats disponibles (JSON, CSV, GeoJSON) et l'URL du point de terminaison API.
- Utilisez des requêtes HTTP GET standard vers le point de terminaison API; de nombreux points de terminaison prennent en charge des paramètres de filtre, de pagination et d'ordre.
- Vérifiez les métadonnées de l'ensemble de données pour la fréquence de mise à jour et les horodatages "dernière mise à jour" avant de vous fier aux données pour des fins de conformité ou d'application.
Authentification, limites de taux et bonnes pratiques
Certains ensembles de données ou services peuvent exiger des clés API ou avoir des limites de taux publiées; lorsque des clés sont requises, le portail ou la page de l'ensemble de données explique comment les demander. Respectez les limites de taux publiées et les recommandations de mise en cache pour éviter les interruptions de service.
- Lisez la page de l'ensemble de données et les notes pour développeurs pour toute étape d'authentification.
- Utilisez des paramètres de requête pour limiter la taille des réponses et mettez en œuvre la gestion des limites de taux côté client.
- Privilégiez les requêtes serveur-à-serveur pour les extractions planifiées afin de réduire la charge côté client.
Sanctions et application
Les pages officielles de données ouvertes de la Ville de Toronto décrivent la licence et l'utilisation acceptable mais n'énumèrent pas les amendes municipales liées spécifiquement à l'accès aux API; les montants pécuniaires précis pour mauvaise utilisation ne sont pas spécifiés sur les pages citées.[3]
- Amendes : non spécifiées sur la page citée.
- Escalade : les détails sur première/réitération/infraction continue ne sont pas spécifiés sur la page citée.
- Sanctions non pécuniaires : la Ville peut retirer l'accès, exiger la cessation d'utilisation ou engager des recours juridiques; les mesures spécifiques ne sont pas spécifiées sur la page citée.
- Application et plaintes : contactez les données ouvertes de la Ville de Toronto ou le service qui publie l'ensemble de données pour signaler des préoccupations.
Demandes et formulaires
Aucun formulaire de demande général n'est requis pour accéder à la plupart des API de données ouvertes ; les pages d'ensemble de données fournissent des points de terminaison directs et toute procédure de demande. Si une clé API ou un accès spécial est requis, l'ensemble de données ou le portail décrira la méthode de demande ou indiquera un formulaire de contact.
Étapes d'action
- Trouvez l'ensemble de données dans le catalogue de la Ville et notez le point de terminaison API et l'horodatage de mise à jour.
- Testez les requêtes dans un environnement contrôlé et mettez en œuvre la gestion des limites de taux.
- Contactez le service éditeur de l'ensemble de données ou l'équipe Open Data pour des questions sur la licence ou des corrections de données.
FAQ
- Dois-je m'enregistrer pour utiliser les API de données ouvertes de Toronto ?
- La plupart des ensembles de données sont accessibles directement sans enregistrement ; si un enregistrement ou une clé API est requis, la page de l'ensemble de données expliquera comment le demander.
- Puis-je republier ou redistribuer les données de la Ville ?
- La redistribution et la réutilisation sont soumises à la licence de données ouvertes de la Ville de Toronto ou aux conditions d'utilisation publiées sur le portail.
- Qui contacter pour des données incorrectes ou manquantes ?
- Contactez le service éditeur de l'ensemble de données indiqué sur la page de l'ensemble de données ou le canal de contact Open Data de la Ville de Toronto pour des corrections.
How-To
- Ouvrez le catalogue Open Data de la Ville de Toronto et recherchez votre sujet.
- Ouvrez la page de l'ensemble de données et copiez le point de terminaison API ou le lien de téléchargement.
- Construisez des requêtes HTTP avec des paramètres de filtrage et de pagination comme indiqué dans les exemples API de l'ensemble de données.
- Respectez le calendrier de mise à jour de l'ensemble de données et incluez les horodatages dans votre flux de travail.
- Signalez les problèmes ou demandez un accès spécial via le contact de l'ensemble de données ou l'équipe Open Data.
Points clés
- La page officielle de l'ensemble de données est la source faisant autorité pour les points de terminaison et les métadonnées.
- La licence et l'utilisation acceptable sont définies sur le portail ; les sanctions pour mauvaise utilisation ne sont pas détaillées sur ces pages.
Assistance / Ressources
- City of Toronto - Open Data
- Open Data Portal
- 311 / Services et contacts de la Ville
- Licence de données ouvertes et conditions