Preguntas frecuentes sobre la API de noticias Fastmarkets
Control de versiones, cadencia de lanzamiento y expectativas de mantenimiento
1. ¿Con qué frecuencia actualiza su versión de API de noticias?
A través de la documentación interna, podemos confirmar múltiples lanzamientos de versiones , cada una de las cuales representa mejoras significativas de funciones en lugar de parches incrementales de rutina.
Las versiones documentadas incluyen:
- API de noticias v1 – diciembre de 2023 Fastmarkets tomó la iniciativa y decidió actualizar la tecnología basada en feeds RSS a una API RESTful
- API de noticias v3 – noviembre/diciembre de 2024
- Actualización de lanzamiento en diciembre de 2024 : ampliación de funcionalidad (filtros, rangos de fechas, paginación).
Los impulsores de las actualizaciones incluyen:
- Adición de nuevos filtros de búsqueda (producto, ubicación, empresa)
- Usabilidad mejorada (paginación, configuración más sencilla sin dependencia de la API de búsqueda)
- Modernización y reestructuración de metadatos de artículos y datos de referencia (esquema v3)
- Actualizaciones de estándares de seguridad (OAuth 2.0, JWT) incluidas en todas las guías de API
Conclusión:
Fastmarkets publica nuevas versiones cuando se introducen mejoras significativas , sin un calendario fijo. Entre los documentos disponibles, se pueden ver tres versiones , todas entregadas a los suscriptores en un plazo aproximado de dos años.
2. ¿Se requieren tareas de mantenimiento regulares para el conector (más allá de los cambios de versión)?
No existe evidencia de que sea obligatorio el mantenimiento periódico de los conectores, más allá de la higiene operativa estándar. Sin embargo, varios factores pueden requerir actualizaciones ocasionales:
Manejo de contenido y metadatos
Rendimiento y estabilidad
No hay nada en la evidencia que indique cambios importantes que requieran mantenimiento continuo, pero se espera que los conectores:
- Manejar la paginación introducido en v3 (diciembre de 2024)
- Admite nuevos filtros y campos si el cliente desea utilizar nuevas funciones de API.
Autenticación
Todas las API dependen de OAuth2 + JWT; cualquier elección de conector de noticias por parte del cliente debe poder actualizar los tokens de manera confiable.
3. ¿ Fastmarkets proporciona un aviso previo o una hoja de ruta para los próximos cambios?
Basado en comunicaciones internas:
- Las actualizaciones de lanzamiento (por ejemplo, el lanzamiento en diciembre de 2024) se anunciaron internamente poco antes del lanzamiento , con recordatorios de no comunicar externamente hasta la aprobación.
- La comunicación externa tiende a ocurrir después del lanzamiento , respaldada por:
- Guías de usuario actualizadas
- Páginas del Centro de ayuda actualizadas (por ejemplo, https://help.fastmarkets.com)
- Anuncios a través de administradores de cuentas o recursos de soporte
Conclusión:
No se publican avisos anticipados de forma rutinaria , pero Fastmarkets proporciona actualizaciones cuando se lanzan funciones y se actualiza la documentación.
4. ¿Las actualizaciones son compatibles con versiones anteriores o requieren ajustes del conector?
La evidencia disponible sugiere:
Las actualizaciones parecen ser compatibles con versiones anteriores , con la opción de incorporar nuevos filtros, campos y paginación. Los conectores deberían seguir funcionando a menos que desee incorporar nuevas funciones.
5. ¿Tiene documentación sobre versiones y cronogramas de desuso?
La documentación disponible actualmente incluye:
- Swagger: Guía del usuario de la API de noticias Fastmarkets V1 { https://api.fastmarkets.com/news/v1/documentation/index.html}
- Guía del usuario de la API de noticias Fastmarkets V3 Buscar {https://help.fastmarkets.com/en_US/apis_sub/fastmarkets-news-api}
¿Cuál es la cadencia de versiones de la API de noticias?
Fastmarkets lanza nuevas versiones de la API de Noticias cuando las mejoras importantes de funciones o estructurales están listas, en lugar de hacerlo según un calendario fijo. En los últimos años, se han lanzado tres versiones clave (v1, v2 implícita y v3) .
Impulsores de las actualizaciones:
Nuevas capacidades de filtrado, metadatos ampliados, desvinculación de las dependencias de la API de búsqueda, paginación mejorada y actualizaciones de seguridad.
Expectativas de mantenimiento:
No se requiere mantenimiento continuo obligatorio, pero los conectores deben gestionar la paginación, la evolución de los metadatos y la renovación de tokens. Es posible que se requieran actualizaciones opcionales para aprovechar las nuevas funciones.
Aviso previo / hoja de ruta:
Fastmarkets generalmente comunica los cambios cerca del momento del lanzamiento , no a través de una hoja de ruta a largo plazo.
Compatibilidad con versiones anteriores:
Sí, históricamente los cambios han sido inquebrantables y las implementaciones de conectores más antiguas continúan funcionando a menos que se deseen nuevas funciones.
Documentación de versiones/desuso:
Existen guías de usuario y documentación de Swagger para cada versión, pero no se ha publicado un cronograma formal de desuso de cada versión.