API 使用指南

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

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

💰 价格介绍

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

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

🌐 接入地址

所有 API 请求统一使用以下生产环境地址：

https://api.justoneapi.com

所有代码示例均使用该地址。

🔐 身份认证

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

https://api.justoneapi.com/your-endpoint?token=your_access_token

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

🚨 响应处理与错误码

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

响应示例

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

业务码说明

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

601 表示账户共享余额不足。602 表示当前 API TOKEN 自身的累计消费上限已达到。TOKEN 限额不是资金划拨，多个 TOKEN 仍共享同一个账户余额。

⏱ 超时建议

虽然大多数请求会在数秒内完成，我们建议将请求超时时间设置为 120 秒；如果 120 秒对你的业务场景来说偏长，请至少设置为 60 秒，但可能会有少量请求因超时而未接收到结果。

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

🚦 限流与配额

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

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

管理员可能会按“用户 × 接口”为账户配置每日成功请求限额；未配置时不限制。每日限额按 Asia/Shanghai（UTC+8）自然日计算：同步请求归入请求发起日，异步任务归入任务提交日。同一账户下所有 TOKEN 的请求合并计数，仅业务返回 code=0 的成功请求计入限额。

达到每日限额后，该接口会返回业务码 303 和 HTTP 状态码 429，超限请求不会计费。

📦 SDK 支持

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

• Python SDK : justoneapi-python

🤖 MCP 支持

为了让 AI 助手轻松发现并调用接口，我们提供官方 MCP 服务：

• MCP 服务 : justoneapi-mcp

🛠 技术支持与反馈

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

👉 联系我们