新闻API怎么接入频道列表分页同步与版权边界如何处理
新闻 API 接入应先拉取频道，再按频道分页获取新闻；但官方页面明确限制其仅用于内部数据分析和机器学习，不得直接用于终端展示，接入前必须先确认授权边界。
新闻 API 有哪些接口
截至 2026 年 8 月 17 日，极速数据新闻 API 官方文档列出两个端点：频道接口用于取得可用频道，新闻接口用于按指定频道获取一批新闻。文档没有列出独立的新闻详情端点。
| 任务 | 端点 | 业务参数 |
|---|---|---|
| 获取新闻频道 | https://api.jisuapi.com/news/channel | 无 |
| 按频道获取新闻 | https://api.jisuapi.com/news/get | channel 必填；num、start 可选 |
两个端点都支持 GET 和 POST，调用时还需要提交 APPKEY。业务系统不要在代码中固定一份频道枚举，应先同步频道接口返回值，再用有效频道调用新闻接口。这样可以避免前端选项与服务端当前频道不一致。
怎样先同步新闻频道
频道接口不需要业务参数，最小 GET 请求如下：
curl --get "https://api.jisuapi.com/news/channel" \
--data-urlencode "appkey=YOUR_APPKEY"
官方示例将 result 作为频道数组处理。业务侧可以把频道名称保存为来源值，并记录最近同步时间；不要自行给频道编造永久 ID，也不要假设频道集合永远不变。
建议按业务需要定时刷新频道，并采用“新值启用、缺失值暂时停用”的更新方式。若某个频道从新结果中消失，不要立即删除历史新闻及其频道字段，否则后续分析将失去上下文。客户端若需要选择频道，应读取自有后端同步后的有效列表，而不是直接持有 APPKEY 请求第三方接口。
新闻列表怎样分页获取
获取新闻时，channel 为必填字符串；num 默认 10，最大 40；start 默认 0，最大 400，相当于 offset。
curl --get "https://api.jisuapi.com/news/get" \
--data-urlencode "appkey=YOUR_APPKEY" \
--data-urlencode "channel=YOUR_CHANNEL" \
--data-urlencode "start=0" \
--data-urlencode "num=40"
生产系统应显式校验 start 和 num 的范围。批量同步可从 start=0 开始，按本次实际返回数量递增偏移；当返回条数少于请求的 num，或接口返回无信息状态时结束本轮。由于文档没有承诺快照分页，跨页期间新闻集合可能变化，不能只依靠页码判断是否已经入库。
start 最大 400 也意味着该接口不适合作为不受限制的全量历史归档入口。若业务需要更深的历史范围、固定快照或大规模数据交付，应先向服务方确认是否有对应产品与授权，不能靠持续翻页推断接口具备这些能力。
返回字段应该怎样建模
新闻结果包含频道、数量和新闻列表。列表字段包括标题 title、时间 time、来源 src、分类 category、图片 pic、内容 content、原文手机网址 url 和原文 PC 网址 weburl。
自有系统可以建立如下内部模型：
{
"source": "jisuapi-news",
"channel": "SOURCE_CHANNEL",
"title": "SOURCE_TITLE",
"publishedAtText": "SOURCE_TIME",
"publisher": "SOURCE_NAME",
"sourceUrl": "SOURCE_URL",
"fetchedAt": "ISO_TIMESTAMP"
}
这是业务侧映射示例，不是官方原始响应。time 在文档中是字符串，入库前应按实际样本验证格式和时区；原始值与解析结果应分别保留。pic、url、weburl 都应允许为空或失效，图片抓取、缓存和再分发还需单独确认授权，不能因为接口返回了链接就默认获得转载权。
没有新闻 ID 时怎样去重和更新
官方返回参数表没有列出稳定的新闻 ID，因此不能把数组位置或分页偏移当作主键。更稳妥的做法是优先规范化原文 URL，并结合标题、来源和发布时间生成内部指纹。
建议按以下顺序处理：
- 优先选取有效的
weburl或url，移除已确认无业务意义的跟踪参数后生成 URL 指纹。 - URL 缺失时，用规范化标题、来源和原始时间组合生成候选指纹。
- 指纹相同但内容、图片或链接发生变化时，更新当前记录并保留抓取时间。
- 指纹不同但标题高度相似时，只标记为可能重复，避免把同一事件的不同来源报道强行合并。
这些指纹是自有系统的去重规则，不是官方字段，也不能证明两条新闻在编辑意义上完全相同。若分析任务需要追踪文章修订，应保存内容摘要值或版本号，而不是每次覆盖后只留下最新文本。
错误码怎样分层处理
新闻接口页面列出的业务错误包括 201 新闻频道不存在、202 关键词为空和 205 没有信息；系统错误码 101 至 108 涉及 APPKEY、权限、请求限制、IP 和接口状态。
201 应触发频道列表刷新并检查提交值，不能循环重试同一个无效频道。205 应作为本轮无数据状态处理。文档列出了 202，但当前两个端点的参数表并没有关键词参数，这属于文档口径差异；接入方应通过正式联调确认它在哪种请求下出现，不要自行给它扩展含义。
APPKEY 或权限类错误应由服务端告警，不能回传密钥细节。请求限制也不应通过无限重试绕过。只有网络超时或临时服务异常适合采用有限次数、带退避的重试，并要防止同一批次并发重复同步。
为什么不能直接做新闻展示页
极速数据新闻 API 页面明确说明，该接口仅用于内部数据分析和机器学习，不得用于终端展示；版权问题需联系发布方获取授权。因此，即使返回值包含标题、正文、图片和原文链接，也不能据此直接搭建面向用户的新闻阅读页、聚合页或公众号自动转载流程。
合规接入至少需要区分三件事：接口调用权限、新闻内容使用授权、图片及原文的展示或再分发授权。三者不能相互替代。若业务目标是终端展示，应先向极速数据及相应发布方确认许可范围、署名要求、可展示字段、保存期限和删除机制，并把书面确认转化为产品规则。
对于允许的内部分析场景，也应控制访问范围、保存期限和导出权限。模型训练或机器学习用途不等于可以公开输出原文；生成结果还需防止大段复现受版权保护的内容，并保留来源和数据版本以便审计。
上线前检查清单
- 先同步频道接口，不在客户端固定频道集合。
- 校验
channel、start和num，遵守偏移与单次数量上限。 - 不把分页位置当新闻 ID，建立可解释的 URL 或组合指纹。
- 原始时间与解析时间分开保存，链接和图片允许失效。
- 分开处理
201、205和系统错误，联调确认202的实际触发条件。 - APPKEY 仅保存在服务端，日志和告警不泄露密钥。
- 默认只用于官方允许的内部分析和机器学习，不把返回内容直接用于终端展示。
- 涉及转载、图片缓存、公开输出或长期归档时，先取得对应授权。
端点、参数、字段、错误码和使用限制可在极速数据新闻 API 官方文档核对。接口能力、授权条款和页面信息可能调整，正式上线前应再次以当前官方文档及书面授权为准。
