API 使用指南

欢迎使用 Just One API 官方文档。我们提供专业、稳定、高效的全能型数据集成服务，提供涵盖多领域的优质 API 接口。

本指南将协助您快速接入我们的服务，内容包括价格介绍、接入地址、身份认证、响应处理与错误码以及限流策略。

💰 价格介绍

您可以登录系统查看各个接口的具体价格： 👉 查看价格

💡 提示： 注册后无需立即充值，系统会提供一定的免费调用次数供您测试。待免费次数用完后，您可以根据需要再进行充值。

🌐 接入地址

当前仅提供一个 API 生产环境：

环境	地址	备注
prod	https://api.justoneapi.com	官方统一生产环境，支持 HTTPS

延迟测试

如果您不确定当前环境的延迟情况，可以通过 /ping 接口进行测试：

• 正常响应通常在几百毫秒内；
• 若 /ping 明显延迟，请检查本地网络或稍后重试。

🔐 身份认证

在调用我们的 API 时，您必须在每个请求中以 URL 参数的形式携带访问令牌（token）：

http://<ip:port>/your-endpoint?token=your_access_token

如需获取访问令牌，请先 注册。

🚨 响应处理与错误码

业务层结果需通过返回体中的 code 字段来判断（code 为 0 表示成功）。

响应示例

{
  "code": 0,
  "message": "",
  "data": { ... }
}

业务码说明

code	含义	是否计费
0	成功	是 💰
100	Token 无效或已失效	否
301	采集失败，请重试	否
302	超出速率限制	否
303	超出每日配额	否
400	参数错误	否
500	内部服务器错误	否
601	余额不足	否
600	权限不足	否

⏱ 超时建议

虽然大多数请求会在数秒内完成，我们建议将请求超时时间设置为 至少 60 秒。

这并不代表 API 很慢，而是为了避免由于短暂的网络抖动或客户端超时导致重复请求或误判错误。

🚦 限流与配额

API 没有通用的调用速率限制。

但部分高并发接口可能会设定特定的速率（如每分钟或每小时），具体说明请参考各接口文档。

📦 SDK 支持

为了简化您的集成工作，我们提供官方 SDK：

• Python SDK : justoneapi-python

🛠 技术支持与反馈

如有问题、对接需求或希望获取定制解决方案，请通过支持页面联系我们：

👉 联系我们