Reglas obligatorias de API de datos abiertos de San Francisco
San Francisco, California exige que los datos municipales sean accesibles y legibles por máquina cuando la ciudad designa conjuntos de datos para su publicación. Este artículo resume las obligaciones prácticas para las agencias y proveedores que operan APIs de Datos Abiertos en San Francisco, describe las expectativas técnicas, las vías de cumplimiento y apelación, y ofrece pasos concretos para publicar o reportar incumplimientos.
Alcance y requisitos
Las agencias deben publicar conjuntos de datos y, cuando esté disponible, proporcionar APIs accesibles por máquina, metadatos estándar y licencias que permitan la reutilización. Los requisitos suelen cubrir el formato de datos (CSV, JSON), metadatos legibles por máquina, documentación del conjunto de datos, cadencia de actualización y declaraciones de licencia claras. La inclusión específica de conjuntos de datos y las exenciones las determina el programa de la ciudad.
- Formatos de datos: JSON, CSV, GeoJSON según lo requiera el portal.
- Metadatos: título, descripción, frecuencia de actualización, punto de contacto.
- Cadencia de actualización: programa de publicación o sello de tiempo de la última actualización.
- Exenciones: privacidad, seguridad o restricciones legales cuando proceda.
Para el alojamiento de conjuntos de datos, DataSF opera el portal de datos abiertos de la ciudad y mantiene orientación técnica y páginas del catálogo para publicadores [1].
Estándares técnicos de API
Las APIs deben soportar endpoints estables, parámetros documentados, paginación, límites de tasa y respuestas legibles por máquina. Los publicadores deben incluir solicitudes de ejemplo y una semántica clara de manejo de errores. Normalmente no se requiere autenticación para conjuntos de datos públicos, aunque puede aplicarse para datos restringidos.
- Endpoints: patrones de URL estables y versionados y nombres de campo consistentes.
- Esquema: tipos de campo documentados, unidades y sistemas de referencia para datos geoespaciales.
- Límites de tasa y paginación: siga la orientación del portal para evitar interrupciones del servicio.
- Documentación: incluya ejemplos, notas de actualización e información de contacto.
Sanciones y cumplimiento
La responsabilidad de hacer cumplir la publicación de Datos Abiertos recae en la Mayoría Oficina de Datos e Innovación y en el programa DataSF; los montos específicos de sanciones o multas estatutarias no se indican en las páginas del programa citadas [2]. Las páginas del portal y del programa describen expectativas de cumplimiento, canales de reporte y seguimiento administrativo en lugar de un calendario publicado de multas.
- Responsable de hacer cumplir: Mayor's Office of Data and Innovation / programa DataSF; coordinan el cumplimiento y la asistencia técnica.
- Inspección y denuncia: reporte problemas del conjunto de datos o de la API a través del contacto oficial o el formulario del portal.
- Apelaciones/revisión: no especificado en la página citada; contacte al programa para los plazos de revisión.
- Multas y sanciones monetarias: no especificado en la página citada.
- Sanciones no monetarias: eliminación del portal, avisos de publicación y direcciones administrativas para subsanar carencias de datos pueden aplicarse.
Solicitudes y formularios
No se listan formularios estandarizados publicados específicamente para el cumplimiento de Datos Abiertos en las páginas del programa; la publicación de conjuntos de datos se gestiona normalmente mediante el flujo de carga de DataSF y el proceso de admisión del programa, o contactando a la Mayor's Office of Data and Innovation para orientación [2].
Preguntas frecuentes
- ¿Quién administra el programa de Datos Abiertos de San Francisco?
- La Mayor's Office of Data and Innovation y el programa DataSF administran el portal de datos abiertos y la orientación técnica.
- ¿La ciudad cobra tarifas para publicar un conjunto de datos?
- Las páginas del programa no listan una tarifa de publicación; la publicación se gestiona a través del portal o el proceso de admisión.
- ¿Cómo reporto un conjunto de datos faltante o incorrecto?
- Reporte los problemas a través del contacto de DataSF o los canales de la Mayor's Office of Data and Innovation; el programa gestiona las solicitudes y asesora a las agencias sobre la remediación.
Cómo hacerlo
- Prepare el conjunto de datos: asegúrese de que los campos, tipos y metadatos descriptivos estén completos.
- Formatee los datos: exporte a CSV/JSON/GeoJSON y valide los esquemas.
- Envíe al portal: use la carga de DataSF o el flujo de admisión y adjunte metadatos y datos de contacto.
- Atienda los comentarios: responda a las solicitudes de revisión del programa y corrija problemas de esquema o privacidad.
- Monitoree y actualice: mantenga el conjunto de datos vigente y responda a los informes de los usuarios.
Puntos clave
- Use formatos estándar y metadatos completos para garantizar la detectabilidad.
- Contacte a DataSF temprano para obtener asistencia técnica y orientación sobre la admisión.
- El cumplimiento se centra en la remediación y en la acción dirigida por el programa más que en un calendario publicado de multas.
Ayuda y soporte / Recursos
- Portal DataSF y recursos para publicadores
- Mayor's Office of Data and Innovation (contacto del programa)
- Board of Supervisors de San Francisco - legislación y código municipal