APIs de datos abiertos de la ciudad de Filadelfia - cómo acceder
Introducción
Filadelfia, Pensilvania publica datos municipales mediante servicios de datos abiertos oficiales para apoyar la transparencia, las aplicaciones, la investigación y la planificación municipal. Esta guía indica dónde encontrar conjuntos de datos, cómo llamar a las APIs públicas, conceptos básicos de autenticación, métodos de acceso comunes y quién aplica los términos de las APIs del portal municipal [1].
Qué publica la ciudad
La ciudad expone conjuntos de datos en un portal público que cubre permisos, inspecciones, estacionamiento, propiedades, transporte y más. Los desarrolladores pueden consultar tablas, filtrar por campo y descargar CSV o JSON mediante endpoints de API. Para documentación del portal y búsqueda de conjuntos de datos use los recursos oficiales para desarrolladores [2].
Cómo acceder a las APIs
- Localice un conjunto de datos en el portal de la ciudad y anote su identificador.
- Use el endpoint base de la API en el portal (los endpoints SODA de Socrata se usan comúnmente para los conjuntos de datos de la ciudad).
- Construya consultas con los ejemplos proporcionados: select, where, order, limit.
- El acceso público de lectura suele ser gratuito; los términos para uso intensivo o comercial están en el portal.
Autenticación y límites de tasa
Muchos conjuntos permiten consultas anónimas; para límites superiores o acceso de escritura puede necesitar un token de aplicación o clave API. Los pasos exactos para solicitar un token y las cifras de límite de tasa están documentados en las páginas para desarrolladores del portal [2].
Sanciones y aplicación
El portal publica términos de uso aceptable y rutas de contacto; las multas monetarias específicas por el uso indebido de la API no figuran en las páginas de desarrolladores citadas [2]. La aplicación normalmente incluye revocación de acceso, limitación de tasa o derivación a la oficina de la ciudad indicada como responsable.
- Montos de multa: no especificado en la página citada.
- Escalada: los procedimientos para infracciones iniciales o repetidas y las sanciones por infracciones continuas no están especificadas en la página citada.
- Sanciones no monetarias: suspensión de acceso, revocación de token de API y limitación de tasa son remedios posibles documentados por el portal o los términos de servicio.
- Entidad aplicadora: Oficina de Innovación y Tecnología de la Ciudad o el departamento que figure en el portal; el contacto oficial está disponible a través de la oficina de tecnología de la ciudad [3].
- Apelaciones/revisión: los procedimientos formales de apelación y los plazos no están especificados en las páginas citadas; contacte a la oficina indicada para procedimientos de revisión.
- Defensas/discrecionalidad: el portal puede permitir exenciones o acuerdos comerciales; no se especifican variaciones concretas en las páginas citadas.
Solicitudes y formularios
El portal documenta cómo solicitar un token de aplicación o registrar una cuenta para límites mayores; si no hay formulario disponible, las páginas para desarrolladores indican autoservicio de cuenta o contactar al helpdesk de la ciudad [2].
Infracciones comunes
- Solicitudes automatizadas excesivas que causan denegación de servicio.
- Intento no autorizado de modificar conjuntos donde solo se permite lectura.
- Uso indebido de datos contrario a la licencia publicada o restricciones de privacidad.
Cómo se hace
- Encuentre un conjunto de datos en el portal de la ciudad y abra su página de conjunto de datos.
- Use las consultas API de ejemplo en esa página para construir su URL de solicitud.
- Si necesita límites mayores, regístrese para un token de aplicación según las instrucciones del portal.
- Pruebe las consultas en un navegador o con curl/Postman, luego integre en su aplicación con almacenamiento en caché para evitar llamadas excesivas.
Preguntas frecuentes
- ¿Los conjuntos de datos de Filadelfia están disponibles gratuitamente para uso comercial?
- Compruebe la licencia de cada conjunto en el portal; muchos se publican para reutilización pública, pero los términos varían.
- ¿Necesito una clave API para leer los datos?
- El acceso de lectura anónimo suele permitirse; se recomienda un token de aplicación para solicitudes automatizadas de alto volumen y está documentado en las páginas para desarrolladores [2].
- ¿A quién contacto por errores de datos o solicitudes de retirada?
- Reporte errores del conjunto de datos o preocupaciones de privacidad a través del contacto de la oficina de la ciudad o el enlace de informe de problemas del conjunto en el portal [3].
Puntos clave
- Use el portal oficial de la ciudad para encontrar identificadores de conjuntos y ejemplos de API.
- Regístrese para un token cuando necesite límites mayores; respete los límites de tasa.
- Contacte a la Oficina de Innovación y Tecnología de la ciudad para la aplicación o problemas de datos.
Ayuda y soporte / Recursos
- City of Philadelphia - Open Data
- data.phila.gov (portal de datos de la ciudad)
- Oficina de Innovación y Tecnología de la Ciudad