Fastmarkets新闻 API 常见问题解答
版本控制、发布周期和维护预期
1. 你们多久更新一次新闻API版本?
从内部文档中,我们可以确认有多个版本发布,每个版本都包含了重要的功能改进,而不是例行的增量补丁。
已记录的版本包括:
- 新闻 API v1 – 2023 年 12 月, Fastmarkets率先将基于 RSS 源的技术升级为 RESTful API。
- 新闻 API v3 – 2024 年 11 月/12 月
- 2024 年 12 月版本更新——功能扩展(筛选、日期范围、分页)。
更新的驱动因素包括:
- 新增搜索筛选条件(商品、地点、公司)
- 提升了易用性(分页功能,无需依赖Search API 即可轻松设置)
- 文章元数据和参考数据的现代化和重组(v3模式)
- 所有 API 指南均已包含安全标准更新(OAuth 2.0、JWT)。
结论:
Fastmarkets新版本并非按固定时间表发布,而是在引入重大改进时才会发布。在已发布的文档中,可以看到 3 个版本,所有版本均在大约两年内交付给订阅用户。
2. 除了版本变更之外,连接器是否需要定期执行的维护任务?
目前尚无证据表明连接器需要除日常维护保养外进行强制性定期维护。但是,因以下几个因素可能需要偶尔进行更新:
内容和元数据处理
性能与稳定性
目前没有任何证据表明存在需要持续维护的重大变更,但连接器预计会:
- 处理 v3 版本(2024 年 12 月)中引入的分页功能
- 如果客户想要使用新的 API 功能,则需要支持新的筛选和字段。
认证
所有 API 都依赖于 OAuth2 + JWT,任何客户选择的新闻连接器都必须能够可靠地刷新令牌。
3. Fastmarkets是否会提前通知或提供即将发生的变化的详细规划?
根据内部沟通情况:
- 发布更新(例如,2024 年 12 月发布)在发布前不久在内部宣布,并提醒在最终批准之前不要对外沟通。
- 对外沟通通常在产品发布后进行,主要依据以下几点:
- 更新后的用户指南
- 更新后的帮助中心页面(例如,https://help.fastmarkets.com)
- 通过客户经理或Support Resources发布的公告
结论:
Fastmarkets不会定期发布提前通知,但会在功能发布和文档更新后提供更新信息。
4. 更新是否具有向后兼容性,还是需要调整连接器?
现有证据表明:
更新具有向后兼容性,可以选择采用新的筛选、字段和分页功能。除非您希望集成新功能,否则连接器应该可以继续正常工作。
5. 你们是否有关于版本控制和弃用时间表的文档?
目前可查阅的文档包括:
- Swagger: Fastmarkets新闻 API 用户指南 V1 { https://api.fastmarkets.com/news/v1/documentation/index.html}
- Fastmarkets新闻 API 用户指南 V3 搜索{https://help.fastmarkets.com/en_US/apis_sub/fastmarkets-news-api}
新闻API版本更新周期是怎样的?
Fastmarkets新闻 API 新版本并非按固定时间表发布,而是在重大功能改进或结构改进完成后才会发布。过去几年中,已发布了三个关键版本(v1、v2(隐含版本)、v3) 。
更新驱动因素:
新增筛选功能、扩展元数据、与Search API 依赖关系的解耦、改进分页以及安全更新。
维护预期:
无需强制性持续维护,但连接器应能处理分页、元数据更新和令牌续期。可能需要进行可选更新才能使用新功能。
提前通知/计划:
Fastmarkets通常会在发布时间前后公布变更,而不是通过长期计划来传达。
向后兼容性:
是的——从历史上看,这些更改都不会造成破坏性影响,除非需要新功能,否则旧的连接器实现方式将继续运行。
版本控制/弃用文档:
每个版本都有用户指南和 Swagger 文档,但没有发布正式的版本弃用时间表。