Guía de API de Open Data de la ciudad para organizaciones sin fines de lucro en Manhattan
Las organizaciones sin fines de lucro de Manhattan pueden usar los conjuntos de datos públicos de la ciudad para apoyar servicios, solicitudes de subvención, investigación y defensa. Esta guía explica cómo las entidades con sede en Manhattan, Nueva York, solicitan acceso a las APIs, registran tokens de aplicación, cumplen obligaciones municipales y dónde informar problemas o solicitar excepciones. Cubre la incorporación técnica, errores frecuentes de cumplimiento, vías de ejecución y pasos prácticos para solicitar tokens, gestionar límites de tasa y apelar suspensiones. La orientación hace referencia a páginas oficiales y documentación de desarrolladores para que el personal de la organización pueda actuar de forma concreta respetando las normas municipales.
Descripción general del acceso a la API de Open Data
La ciudad de Nueva York publica miles de conjuntos de datos a través del portal de Open Data y proporciona endpoints de API para acceso programático. Para los conjuntos de datos gestionados por la ciudad, la Oficina del CTO y DoITT supervisan el programa y publican políticas y recursos de soporte en el sitio oficial de Open Data.Programa Open Data de DoITT[1] Los desarrolladores usan habitualmente endpoints Socrata y tokens de aplicación para autenticar y aumentar límites de tasa; la documentación del proveedor explica el registro de tokens y buenas prácticas.Guía de tokens de aplicación de Socrata[2] El portal de la ciudad también muestra páginas de conjuntos de datos, endpoints de API y metadatos para cada conjunto.
Sanciones y ejecución
La ejecución de los términos de la API la gestionan la oficina del programa y los operadores de la plataforma; las acciones habituales incluyen limitación, suspensión temporal de claves y terminación de acceso por incumplimientos. No se describen multas monetarias por el mal uso de la API en las páginas oficiales citadas; los importes específicos de multas no están especificados en la página citada.Programa Open Data de DoITT[1]
- Multas monetarias: no están especificadas en la página citada.
- Suspensión de acceso o revocación de claves por solicitudes automatizadas abusivas o violaciones de términos.
- Acciones del operador de la plataforma: limitación de tasa, bloqueos temporales y finalización de cuentas.
- Organismo ejecutor: DoITT/Programa Open Data y equipos de soporte de la plataforma; las quejas y soporte empiezan en la página de contacto de DoITT.Programa Open Data de DoITT[1]
Apelaciones, revisión y plazos
Las páginas citadas describen canales de soporte y contacto pero no publican plazos de apelación estatutarios ni pasos formales de apelación administrativa para suspensiones de API; los plazos para apelaciones no están especificados en la página citada.Programa Open Data de DoITT[1]
Defensas y discrecionalidad
- Excusa razonable o remediación: solicite remediación siguiendo los procedimientos de soporte en el portal de la ciudad.
- Permisos/variaciones: no suelen aplicarse a acceso de API; las excepciones técnicas las gestiona el administrador del programa.
Infracciones comunes
- Solicitudes no autenticadas excesivas que causan riesgo de denegación de servicio.
- Raspado que ignora robots o límites de tasa.
- Uso indebido de datos contrario a la licencia o términos específicos del conjunto de datos.
Solicitudes y formularios
No existe un formulario municipal separado para el acceso a la API; los desarrolladores registran tokens de aplicación según la documentación de la plataforma del proveedor. Los tokens se solicitan mediante el sistema de cuentas de la plataforma y la guía del proveedor explica la creación, el uso y los beneficios típicos de límites de tasa.Guía de tokens de aplicación de Socrata[2] Tarifas: no figura ninguna tarifa para crear tokens de desarrollador en las páginas citadas del proveedor.
Cómo empezar (pasos técnicos y de cumplimiento)
A continuación se indican pasos prácticos que deben seguir las organizaciones sin fines de lucro de Manhattan para incorporarse de forma segura y conforme a las APIs de Open Data de la ciudad.
- Identifique el conjunto de datos en el portal de Open Data y abra su página de metadatos.
- Cree una cuenta de desarrollador en la plataforma y genere un token de aplicación.
- Use el token de aplicación en las solicitudes de API, añada almacenamiento en caché y respete los límites de tasa.
- Supervise el uso, registre errores y contacte a DoITT/soporte para disputas o correcciones de datos.
Preguntas frecuentes
- ¿Necesitan permiso las organizaciones sin fines de lucro en Manhattan para usar Open Data?
- La mayoría de los conjuntos públicos están disponibles según los términos del portal; no se requiere un permiso municipal especial, pero las organizaciones deben respetar las licencias y términos del conjunto de datos.
- ¿Tiene coste obtener un token de API?
- No figura ninguna tarifa para crear tokens en las páginas de desarrollador citadas; los tokens se crean mediante el sistema de cuentas de la plataforma.
- ¿Qué hago si se suspende mi clave de API?
- Siga los pasos de soporte y remediación publicados por DoITT y el operador de la plataforma; los plazos formales de apelación no están especificados en las páginas citadas.
Cómo hacerlo
- Identifique el conjunto de datos y su página de metadatos en el portal de Open Data.
- Genere una cuenta de desarrollador y solicite un token de aplicación.
- Implemente el token en las solicitudes de API con cacheo y respeto de límites de tasa.
- Monitoree el uso y contacte a DoITT/soporte para disputas o correcciones.
Puntos clave
- Registre tokens y cumpla los límites de tasa para proteger el acceso.
- La ejecución se centra en la suspensión y limitación; las multas monetarias no están especificadas en las páginas citadas.
- Utilice los canales oficiales de DoITT para informar problemas o solicitar remediación.
Ayuda y soporte / Recursos
- Programa Open Data de DoITT - información y contactos oficiales
- Portal NYC Open Data - páginas de conjuntos y endpoints de API
- Centro de desarrolladores Socrata - referencia de API y buenas prácticas
- Mayor's Office of Data Analytics (MODA)