API 使用指南

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

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

💰 价格介绍

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

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

🌐 接入地址

默认推荐使用 prod-global，同时提供中国大陆地区可选的 prod-cn 环境：

环境	地址	备注
prod-global	https://api.justoneapi.com	默认推荐
prod-cn	http://47.117.133.51:30015	中国大陆地区可选，如真实接口完整响应更快可切换

默认请使用 https://api.justoneapi.com（prod-global）。是否需要切换环境，建议以真实接口调用的完整耗时为准；如果您在中国大陆地区发现 prod-global 完整响应时间较长，或实测 prod-cn 更快，可以切换到 prod-cn：http://47.117.133.51:30015。

速度说明

接口速度不能通过 /ping 单独判断。实际耗时主要包括客户端请求到服务器、服务器业务采集处理、以及服务端返回后客户端完整接收数据的时间。通常服务器业务采集处理时间更长，因此客户端请求到服务器的耗时通常不是主要因素。

建议直接以真实接口调用的完整耗时为准。默认使用 prod-global；如果您在中国大陆地区发现完整响应时间较长，或实测 prod-cn 更快，可以切换到 prod-cn。

🔐 身份认证

在调用我们的 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

🛠 技术支持与反馈

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

👉 联系我们