前提:有效的 Nightwatch 订阅。Data API 包含于订阅,无需额外购买。
1. 生成 API Key
- 登录后进入账户页,找到「API 访问」分区。
- 点击生成 Key,填一个 label(必填,不超过 64 字符,例如
my-bot)。 - Key 明文只在生成时显示一次,立即复制保存。之后列表里只能看到 label 与创建时间,无法再查看明文;丢失只能撤销后重新生成。
2. 第一个请求:/v1/discover
用你的 Key 调用自描述端点,确认鉴权可用并查看当前配额与能力目录:
discover 不消耗月配额,可以放心用于会话开头的自检。
3. 读懂响应信封
所有端点的成功响应都是同一个形状:业务数据在data,请求元信息(request_id、数据新鲜度、分页游标等)在 _meta。错误响应则只有 error 对象,包含 code、message、hint 与文档链接。详见通用约定。
4. 调一个数据端点
取最新披露的国会议员交易(全市场端点,无参数):部分按标的查询的端点在首次请求某个冷门标的时会返回
202——这不是错误,表示数据正在准备,按响应里的 retry_after_seconds 稍后重试即可(通常几秒内就绪)。行为详见数据新鲜度。下一步
- 浏览数据目录,看各领域提供什么
- 在顶部「API Reference」标签页查看每个端点的参数与响应结构,或直接消费 OpenAPI spec
- 用 AI 工具?两分钟接好 MCP
- 写自动化程序前,先读配额与限流与错误处理