APIs de datos abiertos de Tucson - Guía de acceso
Tucson, Arizona publica conjuntos de datos municipales a través del Portal de Datos Abiertos de la Ciudad de Tucson para apoyar la transparencia y la reutilización. Esta guía muestra cómo localizar conjuntos de datos, llamar a endpoints de API, manejar la autenticación y los límites de uso, y dónde solicitar registros no publicados. Use el portal oficial para endpoints canónicos y la página del programa de Datos Abiertos de la ciudad para políticas y contactos. Siga los pasos del How-To abajo para conectar, probar consultas y reportar problemas al personal de la ciudad.
Comenzando con la API de Datos Abiertos de Tucson
La mayoría de los conjuntos de datos de la Ciudad de Tucson son accesibles mediante endpoints REST que siguen las convenciones de la API de Socrata. Puede consultar conjuntos de datos con solicitudes HTTP GET, filtrar usando SoQL y obtener salidas en CSV, JSON o GeoJSON. Para encontrar un conjunto de datos, busque en el catálogo del portal y abra la página del conjunto para ver su endpoint de API y ejemplos de consultas; el portal lista los campos disponibles y los identificadores únicos del recurso.
Portal de Datos Abiertos de Tucson[1] proporciona páginas de conjuntos de datos, ejemplos de API y botones de exportación directamente en cada registro de conjunto de datos.
- Encuentre páginas de conjuntos de datos a través del catálogo del portal y haga clic en "API" en la vista del conjunto de datos para ver endpoints y ejemplos de consultas.
- Copie el identificador del conjunto de datos y use endpoints con la forma
https://data.tucsonaz.gov/resource/RESOURCE_ID.jsonpara salida JSON. - Revise los metadatos del conjunto de datos para la frecuencia de actualización y las marcas de tiempo "última actualización" antes de usar los datos en decisiones sensibles al tiempo.
- El acceso público a la API suele ser gratuito para un uso razonable; los acuerdos de licencia comercial o exportes masivos pueden requerir contactar a la ciudad.
Autenticación, límites y buenas prácticas
Normalmente se permiten solicitudes anónimas para conjuntos de datos públicos, pero las solicitudes autenticadas con un token de aplicación reducen el throttling y mejoran los límites de tasa. Siga las indicaciones del portal para incluir un encabezado X-App-Token y cumpla cualquier política de uso publicada.
- Obtenga un token de aplicación según las instrucciones del portal para aumentar los límites de tasa e identificar su aplicación.
- Use paginación razonable y limite las consultas para evitar sobrecargar la API.
- Almacene en caché resultados cuando sea práctico y respete las marcas de tiempo de última actualización para reducir solicitudes repetidas.
Sanciones y aplicación
El portal de la Ciudad de Tucson y sus páginas de conjuntos de datos proporcionan términos de uso e información de licenciamiento, pero no enumeran multas monetarias ni sanciones penales por el uso indebido de la API en las páginas del portal; dichos detalles de aplicación no están especificados en la página citada. La aplicación del uso indebido de sistemas de la ciudad normalmente la gestionan los departamentos de Tecnologías de la Información o la oficina legal de la ciudad y puede implicar la suspensión del acceso, recursos civiles o remisión a la policía cuando corresponda.[2]
- Multas monetarias: no especificado en la página citada.
- Escalada: la página del portal no lista rangos de multas para primera/reincidencia; la escalada no está especificada en la página citada.
- Sanciones no monetarias: suspensión o terminación de acceso, acción administrativa o remisión legal pueden ocurrir según lo aplique la ciudad.
- Aplicador y quejas: Servicios de Tecnologías de la Información y la Secretaría de la Ciudad administran el acceso y las solicitudes de registros; use canales oficiales para reportar abusos.
- Apelaciones y revisión: el portal no especifica plazos de apelación; las apelaciones o disputas se manejan mediante procesos administrativos de la ciudad o asesoría legal y no se detallan en el portal.
Solicitudes y formularios
Para acceder a registros públicos no publicados en el portal, presente una Solicitud de Registros Públicos ante la Secretaría de la Ciudad según los procedimientos municipales; el portal en sí no requiere un formulario específico para el acceso a la API. Si necesita acceso ampliado o un acuerdo especial de datos, contacte al programa de Datos Abiertos o a Servicios de TI para obtener instrucciones.
How-To
- Abra el Portal de Datos Abiertos de la Ciudad de Tucson y busque el conjunto de datos que necesita.
- Abra la página del conjunto de datos, ubique el ID de recurso y revise los campos disponibles y las consultas de ejemplo.
- Construya una solicitud API usando el endpoint del recurso (por ejemplo,
/resource/RESOURCE_ID.json) y pruebe filtrando con SoQL. - Solicite un token de aplicación si espera tráfico de alto volumen o uso en producción e inclúyalo en el encabezado X-App-Token.
- Reporte errores, problemas de metadatos o solicite datos no publicados a través de los contactos del programa de Datos Abiertos o mediante una Solicitud de Registros Públicos si es necesario.
FAQ
- ¿Necesito una clave API para usar los datos abiertos de Tucson?
- El acceso anónimo suele estar disponible, pero se recomienda un token de aplicación para límites de tasa más altos y acceso estable.
- ¿Dónde encuentro el endpoint API de un conjunto de datos?
- Abra la página del conjunto de datos en el portal y haga clic en "API" o "Exportar" para ver el endpoint REST y las consultas de ejemplo.
- ¿Cómo solicito datos que no están publicados en el portal?
- Presente una Solicitud de Registros Públicos ante la Secretaría de la Ciudad o contacte al programa de Datos Abiertos para orientación sobre solicitudes grandes o sensibles.
Ayuda y recursos
- Portal de Datos Abiertos de la Ciudad de Tucson
- Programa de Datos Abiertos de la Ciudad de Tucson
- Solicitud de Registros Públicos - Secretaría de la Ciudad