Guía municipal de clave API de datos abiertos de Filadelfia
Los desarrolladores que trabajan con conjuntos de datos municipales en Filadelfia, Pensilvania deben entender cómo solicitar y usar una clave API de Datos Abiertos para acceder a los conjuntos de datos y API municipales. Esta guía explica quién administra las claves, cómo solicitarlas, los términos de uso esperados, las vías de cumplimiento y pasos prácticos para desarrolladores que integran datos de Filadelfia en aplicaciones.
¿Qué es una clave API de Datos Abiertos?
Una clave API de Datos Abiertos (app token) es una credencial de máquina usada para identificar una aplicación al llamar a la API de datos de la ciudad; ayuda a gestionar límites de velocidad, monitorizar el uso y aplicar los términos de servicio. La ciudad publica conjuntos de datos y acceso a la API en el portal oficial data.phila.gov[1].
Solicitud de una clave API
Los pasos típicos para acceder a la API en Filadelfia son registrar una cuenta en el portal de datos de la ciudad, crear o registrar una aplicación y aceptar los términos de servicio del portal. La orientación oficial para desarrolladores y notas prácticas están disponibles en las páginas del proyecto Open Data de la ciudad.[2]
- Crear una cuenta en el portal de datos e iniciar sesión.
- Registrar su aplicación o solicitar un app token desde la configuración de su cuenta.
- Registrar el app token de forma segura e incluirlo en las solicitudes API según requiera el portal.
- Revisar los términos de uso y cualquier información publicada sobre tarifas o límites; las tarifas por acceso a la API no están especificadas en las páginas citadas.
Sanciones y ejecución
Los términos de la API publicados por la ciudad y la guía de datos abiertos establecen reglas de uso aceptable y ejecución. No se especifican multas monetarias concretas en las páginas citadas. La ejecución normalmente incluye la suspensión o terminación del acceso a la API, límites de velocidad y eliminación de aplicaciones que violen los términos.[1] La Oficina de Innovación y Tecnología y el equipo de Open Data de la ciudad son los contactos principales para consultas de cumplimiento y sanciones.[3]
- Multas monetarias: no especificadas en las páginas citadas.
- Sanciones técnicas: limitación de velocidad, suspensión o terminación de tokens API.
- Acciones administrativas/judiciales: no especificadas en las páginas citadas.
- Vía de reporte: contacte la oficina de Open Data o los canales de cumplimiento de OIT para quejas e investigaciones.[3]
Solicitudes y formularios
No hay un formulario en papel publicado para una clave API municipal; los desarrolladores registran y gestionan app tokens a través del portal de datos de la ciudad o las páginas de orientación para desarrolladores mantenidas por la ciudad. Las tarifas o números de solicitud formales no están especificados en las páginas citadas.[2]
Preguntas frecuentes
- ¿Necesito permiso para usar datos abiertos de Filadelfia en mi app?
- La mayoría de los conjuntos de datos públicos están disponibles bajo los términos de uso del portal; revise las licencias específicas de cada conjunto de datos y los términos del portal antes de publicar. Contacte al equipo de Open Data para restricciones específicas de conjuntos de datos.[2]
- ¿Hay una tarifa por una clave API?
- Las páginas oficiales citadas no especifican una tarifa para obtener una clave API; los desarrolladores deben revisar los términos del portal y contactar a la oficina de Open Data para confirmación.[1]
- ¿Cómo reporto abuso o un problema de seguridad?
- Reporte abuso o incidentes de seguridad a la Oficina de Innovación y Tecnología de la ciudad o al contacto de Open Data indicado en las páginas oficiales; consulte Recursos abajo.[3]
Cómo hacer
- Visite el portal de datos oficial y cree una cuenta.[1]
- En la configuración de su cuenta, registre una nueva aplicación o solicite un app token como se describe en las páginas de orientación para desarrolladores.[2]
- Registre el token e inclúyalo en las solicitudes API según los ejemplos y requisitos de encabezado del portal.
- Si encuentra restricciones o acciones de ejecución, contacte al equipo de Open Data o a OIT para obtener orientación sobre revisión y apelación.[3]
Puntos clave
- Registre una cuenta en el portal oficial para obtener y gestionar su token de aplicación.
- Revise los términos del portal y las licencias de los conjuntos de datos para evitar suspensión o terminación.
- Contacte a la Oficina de Innovación y Tecnología o al equipo de Open Data para preguntas sobre ejecución o apelaciones.[3]
Ayuda y soporte / Recursos
- Portal de datos de la Ciudad de Filadelfia
- Recursos para desarrolladores de OpenDataPhilly
- Oficina de Innovación y Tecnología - Ciudad de Filadelfia