API 使用指南

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

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

---

💰 价格介绍

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

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

🌐 环境选择

为了确保全球用户都能获得最佳的访问速度与稳定性，我们提供多个 API 环境节点。您可以根据所在的地理位置选择最合适的节点：

地区	推荐环境	环境地址	备注
中国大陆	prod-cn	http://47.117.133.51:30015	推荐：针对大陆网络深度优化，速度最快
中国大陆以外地区	prod-global	https://api.justoneapi.com	兼容性广，支持 HTTPS

💡 接入建议

如果您在中国大陆地区进行开发，强烈建议在正式代码中使用 prod-cn 节点。

请注意：由于浏览器安全策略限制，本在线文档的“测试接口”功能仅支持 HTTPS 的 prod-global 节点。但这不影响您在本地代码（如 Python, Java, Go 等）中使用 prod-cn。

延迟测试

如果您不确定当前环境的延迟情况，可以通过 /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 没有通用的调用速率限制。

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

🛠 技术支持与反馈

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

👉 联系我们