Guía API de datos abiertos de Austin - Datos y ordenanzas
Los desarrolladores en Austin, Texas pueden usar el Portal de Datos Abiertos de la Ciudad de Austin para consultar conjuntos de datos municipales, integrar flujos en vivo y crear aplicaciones de interés público cumpliendo las políticas de datos y las ordenanzas de la ciudad. Esta guía explica cómo acceder a la API del portal, obtener credenciales cuando sea necesario, entender límites de tasa y reglas de uso aceptable, y seguir los procedimientos municipales para registros y cumplimiento. Destaca los departamentos responsables de la publicación y el cumplimiento de datos, los riesgos legales comunes y los pasos prácticos para reportar problemas o apelar decisiones. Use los enlaces a recursos oficiales de la Ciudad de Austin abajo para detalles autorizados y confirmar normas y puntos de contacto vigentes.[1]
Comenzando con la API de Datos Abiertos
La mayoría de los conjuntos de datos públicos están disponibles en el Portal de Datos Abiertos de la Ciudad de Austin y se pueden consultar a través de un endpoint API compatible con Socrata. Los endpoints exponen formatos JSON, CSV y GeoJSON y admiten filtrado, paginación y metadatos específicos del conjunto de datos. Para muchos conjuntos puede realizar solicitudes sin autenticación, pero los endpoints de mayor tasa o restringidos pueden requerir un token de aplicación o clave API y el cumplimiento de los términos del portal.[1]
- URL base de la API y descubrimiento de conjuntos: use el catálogo del portal para encontrar identificadores de conjuntos de datos.
- Límites de tasa y limitación: revise los límites publicados por el portal y aplique backoff en respuestas 429.
- Esquema de datos y tipos de campo: inspeccione los metadatos del conjunto antes de usar en producción.
Autenticación, claves y límites de tasa
Solicite un token de aplicación cuando necesite mayor rendimiento o para obedecer reglas del proveedor; la Ciudad documenta las prácticas recomendadas en la página del programa de Datos Abiertos y en el propio portal. Si un endpoint requiere autenticación, siga las instrucciones del portal para creación de tokens y almacenamiento seguro. Para solicitudes formales de registros públicos más allá de los datos del portal, consulte la secretaria de la ciudad o las páginas de gestión de registros para los procedimientos formales.[2]
Sanciones y aplicación
La Ciudad de Austin aplica las políticas de uso aceptable y de publicación de datos mediante los departamentos propietarios de los datos y, cuando procede, a través de ordenanzas municipales. Las multas monetarias específicas, los calendarios de escalación y las sanciones civiles por el uso indebido del portal no siempre están detalladas en las páginas del portal; cuando el Código Municipal regule el acceso no autorizado o el uso indebido, consulte el Código de Ordenanzas para disposiciones y sanciones aplicables.[3]
- Importes de multas: no especificado en las páginas citadas del portal; consulte el código municipal para delitos y sanciones relacionadas.[3]
- Escalación: rangos para primera, repetida y continuada no se especifican en el portal y deben confirmarse en la ordenanza aplicable o regla administrativa.[3]
- Sanciones no monetarias: suspensión de acceso por el departamento, órdenes administrativas de eliminación o corrección, o remisión a asesoría legal y acciones judiciales.
- Responsable y vía de denuncia: los responsables de datos dentro del programa de Datos Abiertos y el departamento propietario hacen cumplir el cumplimiento; presente incidencias vía el contacto oficial de Datos Abiertos o la página de contacto del departamento.[2]
- Apelación y revisión: los procedimientos de apelación y plazos dependen del departamento que aplica y de la ordenanza; los plazos específicos no están indicados en las páginas del portal y deben confirmarse con la oficina que aplica o la cita del código.[3]
Solicitudes y formularios
Para tokens de API y soporte de desarrollador use el flujo de solicitud de tokens del portal cuando esté publicado; para solicitudes formales de registros públicos o disputas presente una solicitud de información pública a través de la Secretaría de la Ciudad o el proceso de Gestión de Registros. El portal documenta procedimientos de acceso a tokens; los formularios de solicitud de registros formales y las tarifas son publicados por la Secretaría de la Ciudad o la oficina de registros y no siempre están en las páginas de datos abiertos.[2]
Infracciones comunes y resultados típicos
- Solicitudes automáticas excesivas sin token: puede activar limitación o bloqueos temporales de IP.
- Uso de conjuntos restringidos sin autorización: podría resultar en eliminación de acceso y medidas administrativas.
- Republicar datos de la ciudad con atribución falsa o metadatos alterados: sujeto a eliminación y órdenes de corrección.
Pasos de acción para desarrolladores
- Descubra conjuntos en el portal y revise metadatos antes de la integración.
- Contacte al programa de Datos Abiertos para preguntas sobre tokens o publicación.[2]
- Si considera que aplica una ordenanza, consulte el Código de Ordenanzas para las secciones citadas y busque orientación legal o departamental.[3]
FAQ
- ¿Necesito una clave API para leer datos abiertos de la ciudad?
- Muchos conjuntos permiten lecturas sin autenticación, pero un token API puede ser necesario para límites de tasa mayores o endpoints restringidos; consulte la página del conjunto en el portal.[1]
- ¿Dónde informo contenido incorrecto de un conjunto?
- Informe problemas del conjunto al propietario del conjunto a través del mecanismo de comentarios del portal o a la página de contacto del programa de Datos Abiertos para su escalación.[2]
- ¿Qué pasa si mi aplicación es bloqueada por limitación de tasa?
- Primero implemente backoff exponencial y solicite un token si procede; contacte al equipo de Datos Abiertos para explicación o incremento de cuota.
How-To
- Busque el conjunto en el Portal de Datos Abiertos de la Ciudad de Austin y copie su identificador.
- Pruebe una consulta básica sin autenticación usando el endpoint Socrata para confirmar el esquema de respuesta.
- Si necesita mayores límites, siga el procedimiento del portal para solicitar un token de aplicación o contacte al programa de Datos Abiertos.
- Implemente lógica de reintento y backoff y registre respuestas para auditoría y resolución de problemas.
- Si enfrenta acciones de cumplimiento, reúna registros de solicitud y contacte al departamento que aplica para apelar o solicitar aclaración.
Conclusiones clave
- Use el catálogo oficial del portal para descubrir conjuntos y metadatos.
- Las sanciones y multas se rigen por ordenanza o regla departamental y pueden no figurar en el portal.
- Contacte al programa de Datos Abiertos o al propietario del conjunto temprano para resolver acceso, token o problemas de calidad de datos.
Ayuda y soporte / Recursos
- Portal de Datos Abiertos de la Ciudad de Austin
- Programa de Datos Abiertos de la Ciudad de Austin
- Código de Ordenanzas de la Ciudad de Austin