FIELD GUIDE

从第一条请求,到读懂统一响应

先把一条数据流走通:选择能力、给出输入、收到结果,再决定怎样接进自己的应用。这个过程使用固定的虚构样本,无需供应商 Key。

YouTube4 个步骤
准备什么

一个关键词,以及能访问 DataNavoAPI 的浏览器或终端。

你会得到

一份能读懂、能复制、能继续翻页的结构化响应。

全文使用 demo。请求返回固定样本,不消耗供应商额度。

01

选择与你的任务匹配的能力

需要发现内容,先选搜索接口;已经有一条内容的编号,选详情或评论接口。这里以 YouTube 视频搜索为例,关键词填 coffee brewing,排序选择 relevance。

打开下方演示入口后,页面会预选能力;点击“运行”才会发起请求。更换关键词能练习参数流程,但演示内容始终是固定的虚构样本,不代表该词的真实搜索结果。

02

在浏览器或终端发起请求

在浏览器中可以使用调试台。在终端中运行下方命令,即可查看同一份演示响应。

CURL / DEMO
curl --get 'https://datanavoapi.com/v1/youtube/videos/search' \
  -H 'X-Guanliu-Mode: demo' \
  --data-urlencode 'query=coffee brewing' \
  --data-urlencode 'sort=relevance'
03

先读状态,再读数据

HTTP 成功不等于你已经拿到真实数据。先确认 code 为 ok,再检查 meta.mode。demo 表示虚构样本,live 才表示请求走了真实供应商。

搜索返回 data.items 数组;详情或账号查询返回 data.item 对象。计数缺失时可能是 null,不能自行当作 0。需要排查时保存 request_id,查看 warnings 中的提示。

  • code:请求的业务结果。
  • data:供你的应用处理的内容。
  • page:是否还有下一页,以及下一页游标。
  • meta:模式、能力、来源与本次请求信息。
04

翻页与导出

当 page.has_more 为 true 且 next_cursor 有值时,调试台可点击“下一页”。自己写代码时,将完整 next_cursor 作为 cursor 参数,保持关键词与排序不变。不要拆解、修改或跨接口复用游标。

点击“复制响应”,可将 JSON 粘贴到转换工具生成 CSV。先保留原始 JSON,再按自己的用途整理表格;CSV 不保留原始 JSON 的全部类型信息。

打开 JSON 转 CSV 工具
FROM READING TO RUNNING

把这一步,接到接口上。

下面的入口会打开预选能力的演示调试台。点击运行后才发出请求,使用固定虚构数据。

继续阅读