Acceso API al Portal de Datos - Ley de West Raleigh
Los residentes y desarrolladores de West Raleigh, North Carolina dependen cada vez más del Portal de Datos de la Ciudad de Raleigh para conjuntos de datos municipales y endpoints de API. Esta guía explica cómo acceder al portal, solicitar soporte de API o datos, cumplir con los términos municipales y dónde reportar problemas relacionados con la precisión de los datos o el uso indebido de la API. Resume fuentes oficiales, pasos de acción necesarios, problemas comunes de cumplimiento y los departamentos a contactar para soporte técnico o preguntas legales.
Acceso y conceptos básicos de la API
La Ciudad de Raleigh publica conjuntos de datos e información del programa en su Portal de Datos y en las páginas del programa de datos abiertos. Para descubrir conjuntos de datos, ejemplos y endpoints de API visite el portal oficial y la documentación del programa de datos abiertos data.raleighnc.gov[1] y la página del programa de datos abiertos de la Ciudad raleighnc.gov/open-data[2]. Notas técnicas comunes que debe esperar:
- Revise las marcas de tiempo de última actualización y la frecuencia de actualización en las páginas de los conjuntos de datos.
- Los endpoints de API se publican por conjunto de datos; use el enlace API del conjunto de datos para formar consultas.
- Los formatos de datos comunes incluyen JSON y CSV; los detalles del esquema aparecen en cada página de conjunto de datos.
Solicitar acceso y claves de API
Los conjuntos de datos públicos son generalmente accesibles sin credenciales especiales, mientras que algunos conjuntos restringidos o exportaciones masivas pueden requerir una solicitud formal. Para orientación procedural o para solicitar datos restringidos, siga las instrucciones de contacto del programa de datos abiertos de la Ciudad en la página oficial del programa y los campos de contacto específicos del conjunto de datos en el portal raleighnc.gov/open-data[2] y data.raleighnc.gov[1].
- Localice el conjunto de datos y haga clic en las opciones API o Exportar para copiar las URLs de endpoint.
- Contacte al programa de datos abiertos o al responsable del conjunto de datos para correcciones o solicitudes de acceso especial.
- Si se requiere una clave de API, la página del conjunto de datos o la página del programa de datos abierta describirá cómo solicitarla.
Uso de datos, licencias y atribución
Los conjuntos de datos normalmente incluyen metadatos que describen los términos de licencia y los requisitos de atribución. Lea siempre el campo de licencia del conjunto de datos en el portal antes de redistribuir; para políticas a nivel de programa y preguntas legales, consulte la documentación del programa de datos abiertos de la Ciudad de Raleigh raleighnc.gov/open-data[2].
Sanciones y aplicación
La aplicación por el uso indebido del Portal de Datos o las violaciones de los términos de servicio se rige por la política de la Ciudad y la ley aplicable. Las multas monetarias específicas, la escalada o las sanciones estatutarias por el uso indebido de la API no se especifican en las páginas del programa o del portal citadas; consulte el código municipal para vías generales de aplicación y el programa de datos abiertos para prácticas administrativas library.municode.com/nc/raleigh[3] y raleighnc.gov/open-data[2].
- Multas o sanciones monetarias: no especificadas en las páginas citadas.
- Escalada (primera/reincidente/continuada): no especificada en las páginas citadas.
- Sanciones no monetarias: posible suspensión de cuenta, revocación de acceso, solicitudes de eliminación o acciones civiles por canales legales de la ciudad; los remedios específicos no están detallados en las páginas del portal.
- Enforcement: Programa de Datos Abiertos, TI de la Ciudad y la oficina del Fiscal de la Ciudad para la aplicación legal; las rutas de contacto aparecen en las páginas oficiales del programa y del portal raleighnc.gov/open-data[2].
- Vías de inspección y queja: informe errores de datos o usos indebidos mediante el campo de contacto del conjunto de datos o las instrucciones de contacto del programa de datos abiertos.
- Rutas de apelación y plazos: no especificadas en las páginas citadas; consulte el código municipal o contacte al Fiscal de la Ciudad para apelaciones formales library.municode.com/nc/raleigh[3].
- Defensas/discreción: la Ciudad puede considerar permisos o acuerdos de stewardship; los estándares específicos no están publicados en el portal.
Solicitudes y formularios
No hay un formulario público estandarizado para sanciones por uso indebido de la API o apelaciones publicado en el portal o en las páginas del programa de datos abiertos; las solicitudes de acceso restringido o correcciones de datos se gestionan mediante la información de contacto del conjunto de datos o las instrucciones del programa de datos abiertos en el sitio de la Ciudad raleighnc.gov/open-data[2].
Cómo hacerlo
- Busque un conjunto de datos en el portal oficial y abra su página de detalles.
- Copie el endpoint de la API del conjunto de datos (enlace Exportar/API) y revise el esquema y consultas de ejemplo.
- Pruebe consultas en un entorno de desarrollo y respete los límites de velocidad indicados en el portal.
- Contacte al responsable del conjunto de datos o al programa de datos abiertos de la Ciudad para preguntas de acceso o correcciones.
Preguntas frecuentes
- ¿Necesito una clave de API para acceder a los conjuntos de datos?
- Muchos conjuntos de datos públicos son accesibles sin clave; cuando se requieren claves, la página del conjunto de datos o la documentación del programa explica cómo solicitarlas.
- ¿Quién aplica el uso indebido de los datos del portal?
- El Programa de Datos Abiertos y TI de la Ciudad administran el acceso al portal; la aplicación legal puede involucrar al Fiscal de la Ciudad y remedios del código municipal.
- ¿Cómo solicito una corrección en el contenido del conjunto de datos?
- Use la opción de contacto o retroalimentación del conjunto de datos en el portal, o siga las instrucciones de contacto del programa de datos abiertos en el sitio de la Ciudad.
Puntos clave
- Empiece en el portal oficial para encontrar endpoints de API y metadatos.
- Contacte a los responsables del conjunto de datos o al programa de datos abiertos para acceso restringido o correcciones.
Ayuda y soporte / Recursos
- Portal de Datos Abiertos de la Ciudad de Raleigh
- Ciudad de Raleigh - Programa de Datos Abiertos
- Código Municipal de Raleigh (Municode)