快速开始
欢迎使用 BambooDataLab 官方 API。本指南介绍价格、接入地址、身份认证、响应格式与错误码、限流配额等，帮助你快速完成接入并稳定调用。
💰 价格介绍
我们按调用次数计费，每个接口设有固定单价，仅当调用成功（code = 0）时扣费，失败自动退还预扣额度。详细价格请见价格页。
🔌 接入地址
我们会为每位客户单独分配专属接入地址。开通后请联系客服获取你的专属地址（形如 https://<your_endpoint>）。
下文代码示例中的 https://<your_endpoint>，请替换为客服为你分配的实际接入地址。
🔑 身份认证
在调用任意 API 时，需通过查询参数 URL 中传递访问令牌 token：
https://<your_endpoint>/api/<path>?token=<your_access_token>也可通过请求头传递：Authorization: Bearer <your_access_token>。
📨 响应处理与错误码
所有接口均返回如下统一结构，业务字段 code 标识处理结果：
响应示例
json
{
"code": 0,
"message": "ok",
"data": { }
}业务码说明
| code | 含义 | 是否扣费 |
|---|---|---|
0 | 成功 | 是 |
100 | Token 无效或缺失 | 否 |
301 | 触发限流 | 否 |
302 | 额度不足 | 否 |
303 | 采集失败 | 否（退费） |
400 | 请求参数错误 | 否 |
500 | 服务端错误 | 否 |
600 | 无访问权限 | 否 |
601 | 账户余额不足 | 否 |
⏱️ 超时建议
鉴于大多数采集型接口的链路较长，我们建议将客户端请求超时设置为 60 秒。
这类不适合 API 接口，如不想让客户端长时间等待，可结合下文「任务模式」改为异步轮询。
🚦 限流与配额
API 按账户维度进行限流。每个账户的默认 QPS 为 5；如需更高并发，请联系我们升级配额。
🧰 SDK 支持
为方便快速接入，我们提供官方 SDK：
- Python SDK：bamboodatalab-python
🔥 技术支持与反馈
如有问题、对接需求或希望新增接口，欢迎随时联系我们：