APIs y documentación de datos abiertos de la ciudad de Sacramento - FAQ
Introducción
Sacramento, California ofrece un portal oficial de datos abiertos y recursos para desarrolladores con conjuntos de datos municipales, acceso a APIs y documentación para que residentes, investigadores y desarrolladores usen datos para aplicaciones, análisis y transparencia. Esta guía señala el portal de la ciudad, la página de datos abiertos del departamento de Tecnología de la Información y la documentación de la plataforma, y explica cómo descubrir endpoints, licencias y rutas para reportar errores o datos faltantes.[3]
Dónde encontrar APIs y documentación oficial
Comience en el portal de datos abiertos de la Ciudad de Sacramento para explorar conjuntos de datos, encontrar identificadores y probar endpoints de API directamente en la interfaz del navegador.[1]
- Portal de datos abiertos de la ciudad para conjuntos de datos navegables y páginas de vista previa de API.[1]
- Página de Datos Abiertos del Departamento de Tecnología de la Información de la Ciudad de Sacramento para políticas, contactos y información del programa.[2]
- Documentación para desarrolladores de la plataforma (Socrata/OpenData) sobre convenciones de la API SODA, parámetros de consulta y ejemplos de código.[3]
Sanciones y aplicación
El portal oficial de datos abiertos y las páginas de TI de la ciudad no publican sanciones municipales por acceso a datos o uso de APIs; cuando existan disposiciones de aplicación específicas, aparecen en las páginas de términos de uso o en otras políticas de la ciudad. Para contenido de conjuntos de datos regido por otros códigos de la ciudad (privacidad, licencias o registros restringidos), la aplicación sigue el instrumento que controla ese asunto.
- Cantidades de multas: no especificadas en las páginas citadas.
- Escalamiento (primera/reincidente/continuada): no especificado en las páginas citadas.
- Sanciones no monetarias: no especificadas en las páginas citadas; las políticas de la ciudad pueden permitir suspensión de acceso o acciones legales por uso indebido que viole los términos.
- Organismo aplicador: Departamento de Tecnología de la Información o el departamento propietario del conjunto de datos; las quejas y las inspecciones siguen las vías de contacto en las páginas de los conjuntos de datos.
Solicitudes y formularios
El acceso a la API es generalmente público a través del portal; no se requiere un formulario especial para acceso de lectura salvo que un conjunto de datos esté restringido. Para acceso elevado o acuerdos de extracción de datos, contacte al Departamento de Tecnología de la Información o al propietario del conjunto de datos; el portal muestra los campos de contacto cuando están disponibles.
Cómo descubrir endpoints y usarlos
- Abra la página del conjunto de datos en el portal de datos abiertos de la ciudad y localice el identificador del conjunto y el endpoint de la API mostrados en el encabezado de la página.
- Use la vista previa de API del portal o la documentación de la API SODA para probar consultas, filtros, ordenamiento y parámetros de paginación.
- Revise los metadatos del conjunto de datos para la licencia, la frecuencia de actualización y el contacto del departamento para confirmar las reglas de reutilización.
- Reporte problemas de calidad de datos o solicite nuevos conjuntos usando el contacto del conjunto de datos o el formulario de contacto de datos abiertos de TI.
Preguntas frecuentes
- ¿Cómo encuentro el endpoint API de un conjunto de datos?
- Abra la página del conjunto de datos en el portal de datos abiertos de la ciudad y utilice las opciones de API o exportación para revelar el endpoint SODA y el identificador del conjunto.
- ¿Necesito una clave API?
- La mayoría de las solicitudes de solo lectura no requieren clave; consulte el portal y la documentación de la plataforma para límites de tasa y tokens opcionales.
- ¿Cómo solicito un nuevo conjunto de datos o reporto un error?
- Contacte al propietario del conjunto de datos que aparece en la página del portal o use el contacto de datos abiertos del departamento de TI de la ciudad para presentar una solicitud.
Cómo hacer
- Vaya al portal de datos abiertos de la ciudad y busque por tema o palabra clave.
- Abra el conjunto de datos, copie el ID del conjunto y pruebe el endpoint en la vista previa de la API del portal.
- Use los parámetros de la API de la plataforma (filter, select, order) según la documentación del desarrollador para adaptar resultados.
- Si faltan datos o son incorrectos, use el contacto del conjunto de datos o el contacto de TI para enviar una solicitud.
Puntos clave
- Fuente primaria: el portal de datos abiertos de la ciudad contiene conjuntos y enlaces directos a APIs.
- La documentación del desarrollador explica las consultas SODA; revise los metadatos para licencia y frecuencia de actualización.
Ayuda y soporte / Recursos
- Portal de datos abiertos de la Ciudad de Sacramento
- TI de la ciudad - Programa de datos abiertos
- Documentación para desarrolladores de la plataforma (SODA)