APIs de datos abiertos de Sunnyvale - Acceso a datos municipales y ordenanzas
Sunnyvale, California proporciona un portal de datos abiertos donde residentes, investigadores y desarrolladores pueden acceder a conjuntos de datos municipales y registros públicos mediante APIs. Esta guía explica los métodos comunes de acceso por API, dónde encontrar la documentación, formatos de datos, prácticas de solicitudes y límites, y cómo presentar quejas o solicitudes de registros ante la oficina responsable. Use estos pasos para localizar identificadores de conjuntos de datos, llamar a los endpoints e integrar datos en mapas o informes cumpliendo los términos de uso del portal y los procedimientos de la Ley de Registros Públicos de California.
Acceso a conjuntos de datos con APIs
La mayoría de los conjuntos de datos de Sunnyvale se publican en formatos legibles por máquina y exponen endpoints RESTful para exportaciones JSON/CSV y parámetros de consulta para filtrado y paginación. Localice las páginas de conjuntos de datos y la documentación automática de API en el portal de la ciudad, que lista URLs de endpoints, consultas de ejemplo y campos disponibles. Para acceso directo al portal y al explorador de API utilice el sitio oficial Open Data data.sunnyvale.ca.gov[1]. Si necesita registros que no estén publicados, presente una solicitud ante el City Clerk según se describe más abajo.[2]
Tareas comunes con la API
- Encuentre la página del conjunto de datos y use las opciones "API" o "Export" para obtener plantillas de endpoints y listas de campos.
- Use parámetros de consulta para filtrar (where), ordenar (order) y paginar (limit/offset) los resultados para solicitudes eficientes.
- Verifique en los metadatos si hay requisitos de licencia o atribución; los horarios de tarifas no son habituales y no están especificados en la página citada.
- Respete los límites de tasa y las políticas de uso de la API en la documentación del portal; los límites específicos no están especificados en la página citada.
Sanciones y Aplicación
La ciudad publica conjuntos de datos para uso público, pero la aplicación por uso indebido, alteración no autorizada de datos o incumplimiento de términos la realizan oficinas oficiales. Cuando el portal o las páginas de los conjuntos especifican sanciones o pasos de aplicación, esas indicaciones son determinantes; cuando no lo hacen, los remedios y sanciones no están especificados en la página citada y el solicitante debe contactar al City Clerk o al administrador del portal para aclaraciones.[2]
- Autoridad: el City Clerk y el departamento de Servicios Administrativos/Informática supervisan el acceso a registros y la operación del portal; los datos de contacto están en el sitio de la ciudad.
- Multas: las multas monetarias específicas por uso indebido de la API o de los datos no están especificadas en la página citada.
- Escalamiento: aviso inicial, suspensión de acceso o remisión a asesoría legal son escaladas administrativas típicas, pero los pasos específicos no están especificados en la página citada.
- Remedios no monetarios: revocación de claves API, suspensión de acceso automatizado o acciones judiciales cuando se alega conducta ilegal.
- Vías de inspección/queja: presente solicitudes de registros o quejas al City Clerk y reporte problemas del portal al contacto de Informática en el sitio de la ciudad.
- Apelaciones/revisión: cuando se adopta una medida administrativa, las rutas de apelación y plazos legales están regidas por procedimientos municipales o la Ley de Registros Públicos de California; los plazos específicos no están especificados en la página citada.
Solicitudes y Formularios
La ciudad no publica un formulario de licencia API separado en el portal. Para datos o registros que no estén en el portal, presente una solicitud de registros públicos al City Clerk; el formulario en línea o las instrucciones de contacto están disponibles en la oficina del City Clerk. Si no se requiere formulario, la ciudad indica a los solicitantes seguir el procedimiento de solicitud de registros públicos referenciado en la página del City Clerk.[2]
Cómo hacerlo
- Localice el conjunto de datos en el portal Sunnyvale Open Data y abra la página del conjunto.
- Use el enlace API o Export del conjunto para copiar la URL del endpoint REST y los parámetros de consulta de ejemplo.
- Pruebe consultas con un navegador o herramienta (curl, Postman) para confirmar nombres de campo y formato de salida.
- Aplique filtros, límites y rangos de fecha para reducir el tamaño de la carga y respetar los límites de tasa.
- Si los datos necesarios no están publicados, presente una solicitud de registros públicos al City Clerk describiendo el conjunto, el período y el formato preferido.
Preguntas frecuentes
- ¿Necesito una clave API para usar los conjuntos de Sunnyvale?
- No se requiere una clave API universal para muchos endpoints publicados, pero algunos servicios o accesos con mayor tasa pueden requerir registro; consulte la página del conjunto y la documentación del portal.
- ¿Dónde reporto errores o campos faltantes en un conjunto?
- Reporte inexactitudes del conjunto usando las herramientas de retroalimentación del portal o contacte al departamento de Servicios Administrativos/Informática y al propietario del conjunto listado en la página.
- ¿Cómo solicito datos no publicados?
- Presentar una solicitud de registros públicos al City Clerk con una descripción clara de los registros, formato preferido y rango de fechas.
Puntos clave
- Comience en el portal Open Data de la ciudad para encontrar endpoints y metadatos antes de realizar llamadas API.
- Use filtros y límites para mantener las solicitudes eficientes y dentro de las políticas de tasa.
- Contacte al City Clerk para registros no publicados y al departamento de Informática para problemas técnicos del portal.
Ayuda y Soporte / Recursos
- City Clerk - Public Records & Records Requests
- Information Technology - Open Data / Portal Support
- Planning & Building - Datasets related to permits and inspections