API

认证

在请求头传入 X-API-Key: YOUR_API_KEY。不要把密钥放进公开网页或 URL。密钥管理使用客户登录凭证，撤销后旧密钥立即失效。

大额历史交付流程

1. 创建任务：POST /v1/bulk-history/exports
2. 使用返回的任务 ID 查询进度。
3. 任务返回 download_url 后进入交付页。
4. 部分完成时检查 stop_reason 和 resume_available，补充额度后续跑。

每页上限与交付文件的总记录数是两个概念。数据条数与下载 Q&A

分页与额度

历史帖子和评论每次最多读取 100 条。后续请求使用返回的 next_cursor 作为 after_cursor。检查 meta.incomplete、stop_reason 和剩余额度，避免把额度耗尽误认为数据已读取完毕。日期按 UTC 处理。

实时数据与大额历史使用不同额度。调试读取和创建任务也可能消耗额度，请先查询账号用量。

错误处理