Cómo solicitar conjuntos de datos públicos vía API en Open Data municipal de Fresno
Esta guía explica cómo solicitar conjuntos de datos públicos mediante la API Open Data de la Ciudad de Fresno. Cubre cómo localizar conjuntos de datos en Fresno, California, revisar los metadatos y licencias, solicitar acceso o soporte para la API, y los departamentos que gestionan solicitudes de datos y registros. Use este procedimiento para enviar solicitudes técnicas de API, pedir exportaciones de datos o reportar problemas de calidad y acceso a los datos. Para solicitudes legales o formales de registros sobre conjuntos de datos, siga el proceso de registros públicos de la ciudad y contacte al City Clerk o al servicio de TI según se indica a continuación.[1]
Por dónde empezar
Comience en el portal Open Data de la Ciudad de Fresno y busque por nombre del conjunto, palabra clave o departamento. Revise los metadatos de cada conjunto para conocer los endpoints de la API, límites de tasa, claves de API requeridas y términos de licencia antes de realizar solicitudes automatizadas.
Cómo funciona la API normalmente
La mayoría de los portales municipales de datos abiertos exponen endpoints REST y parámetros de consulta para filtrar, ordenar y paginar. Identifique el identificador del conjunto (resource ID) y pruebe las consultas en el explorador de la API del portal o con curl. Respete los límites de tasa, la atribución y los términos de uso publicados.
Multas y ejecución
La Ciudad de Fresno no publica multas o calendarios de sanciones específicos por el uso indebido del acceso a la API Open Data en la página principal del portal; las multas monetarias específicas no están especificadas en la página citada. La ejecución suele corresponder al departamento de Tecnología de la Información de la Ciudad en coordinación con el City Attorney y el City Clerk para disputas legales o de registros.[1]
- Multas: no están especificadas en la página citada; contacte a la ciudad para detalles.
- Escalamiento: no está especificado en la página citada; el escalamiento suele ir desde un aviso informal hasta la suspensión de la cuenta/clave de API y luego acciones legales si es necesario.
- Sanciones no monetarias: posible suspensión o revocación de claves de API, órdenes de eliminación o acciones judiciales (no especificado en la página citada).
- Ejecutor y quejas: Tecnología de la Información y el City Clerk gestionan quejas técnicas y legales; presente un informe oficial o contacte al soporte de TI como se indica abajo.
- Apelaciones y revisión: las rutas de apelación y plazos específicos no están detallados en la página del portal; las apelaciones formales de registros siguen los procedimientos del City Clerk.
Solicitudes y formularios
El portal Open Data no publica un formulario dedicado de "solicitud de API"; las solicitudes técnicas generalmente se manejan por correo de soporte o contacto del portal. Las solicitudes formales de registros públicos usan los procedimientos del City Clerk y cualquier formulario disponible en la página del City Clerk (ver Recursos). Si se requiere una tarifa o solicitud formal para una exportación grande de datos, esa tarifa no está especificada en la página del portal.[1]
Pasos de acción para solicitar un conjunto de datos
- Identifique el conjunto y el resource ID en el portal Open Data.
- Revise los metadatos para endpoints de API, esquema, licencia y límites de tasa.
- Pruebe consultas mediante el explorador de la API del portal o una petición curl sencilla.
- Si persisten problemas de acceso o calidad, contacte al steward del conjunto o al soporte de TI de la ciudad.
- Para información retenida o registros formales, presente una solicitud de Records Act al City Clerk.
Preguntas frecuentes
- ¿Necesito una clave de API para acceder a la API Open Data de Fresno?
- Depende del conjunto y la configuración del portal; revise los metadatos del conjunto para límites de tasa y requisitos de clave de API, o contacte a TI de la ciudad para aclaraciones.[1]
- ¿Puedo comercializar los datos obtenidos de la API Open Data?
- Los términos de la licencia varían por conjunto; revise la licencia en los metadatos del conjunto. Si no hay licencia, contacte al steward o al City Clerk para confirmar permisos de reutilización.[1]
- ¿Cómo reporto datos incorrectos o incompletos?
- Reporte problemas al steward indicado en los metadatos o a TI de la ciudad; para disputas no resueltas, presente una queja formal ante el City Clerk.[1]
Cómo hacerlo
- Abra el portal Open Data de la Ciudad de Fresno y busque el conjunto de datos que necesita.
- Abra la página del conjunto y copie el identificador del recurso o el endpoint de la API que aparece en los metadatos.
- Use el explorador de la API del portal o un cliente REST para probar una consulta de ejemplo y verificar los resultados.
- Si los resultados están incompletos o el acceso está bloqueado, contacte al steward del conjunto o al soporte de TI de la ciudad.
- Para información retenida o registros formales, presente una solicitud de Records Act al City Clerk.
Puntos clave
- Siempre revise los metadatos del conjunto para endpoints de API, licencias y contactos.
- Para registros formales o información retenida, siga el proceso de registros públicos del City Clerk.
Ayuda y soporte / Recursos
- Portal Open Data de la Ciudad de Fresno
- Tecnología de la Información - Ciudad de Fresno
- City Clerk - Registros Públicos
- Código Municipal de Fresno (Municode)