---
title: API 使用指南
description: 了解 JustOneAPI 的认证方式、价格、接入地址、错误码、限流策略、SDK 和 MCP 支持。
---

# API 使用指南

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

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

## 💰 价格介绍

您可以登录系统查看各个接口的具体价格：
👉 [查看价格](https://dashboard.justoneapi.com/zh)

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

## 🌐 接入地址 {#environment-selection}

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

```text
https://api.justoneapi.com
```

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

## 🔐 身份认证

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

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

如需获取访问令牌，请先 [注册](https://dashboard.justoneapi.com/zh)。

## 🚨 响应处理与错误码

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

### 响应示例

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

### 业务码说明

| `code` | 含义 | 是否计费 |
|--------|------|----------|
| `0`    | 成功 | 是 💰 |
| `100`  | Token 无效或已失效 | 否 |
| `101`  | 白名单校验失败 | 否 |
| `202`  | 当前接口版本不支持该参数值，请尝试其他版本。 | 否 |
| `300`  | 接口不存在或已失效 | 否 |
| `301`  | 采集失败，请重试 | 否 |
| `302`  | 超出速率限制 | 否 |
| `303`  | 超出每日配额 | 否 |
| `400`  | 参数错误 | 否 |
| `404`  | 请求的接口地址或服务器资源不存在 | 否 |
| `500`  | 内部服务器错误 | 否 |
| `503`  | 服务暂不可用，请稍后重试 | 否 |
| `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** <svg role="img" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg" width="18" height="18" style="display:inline-block;vertical-align:middle;margin-top:-2px;fill:currentColor;"><path d="M12 .297c-6.63 0-12 5.373-12 12 0 5.303 3.438 9.8 8.205 11.385.6.113.82-.258.82-.577 0-.285-.01-1.04-.015-2.04-3.338.724-4.042-1.61-4.042-1.61C4.422 18.07 3.633 17.7 3.633 17.7c-1.087-.744.084-.729.084-.729 1.205.084 1.838 1.236 1.838 1.236 1.07 1.835 2.809 1.305 3.495.998.108-.776.417-1.305.76-1.605-2.665-.3-5.466-1.332-5.466-5.93 0-1.31.465-2.38 1.235-3.22-.135-.303-.54-1.523.105-3.176 0 0 1.005-.322 3.3 1.23.96-.267 1.98-.399 3-.405 1.02.006 2.04.138 3 .405 2.28-1.552 3.285-1.23 3.285-1.23.645 1.653.24 2.873.12 3.176.765.84 1.23 1.91 1.23 3.22 0 4.61-2.805 5.625-5.475 5.92.42.36.81 1.096.81 2.22 0 1.606-.015 2.896-.015 3.286 0 .315.21.69.825.57C20.565 22.092 24 17.592 24 12.297c0-6.627-5.373-12-12-12"/></svg>: [justoneapi-python](https://github.com/justoneapi-official/justoneapi-python)

## 🤖 MCP 支持

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

- **MCP 服务** <svg role="img" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg" width="18" height="18" style="display:inline-block;vertical-align:middle;margin-top:-2px;fill:currentColor;"><path d="M12 .297c-6.63 0-12 5.373-12 12 0 5.303 3.438 9.8 8.205 11.385.6.113.82-.258.82-.577 0-.285-.01-1.04-.015-2.04-3.338.724-4.042-1.61-4.042-1.61C4.422 18.07 3.633 17.7 3.633 17.7c-1.087-.744.084-.729.084-.729 1.205.084 1.838 1.236 1.838 1.236 1.07 1.835 2.809 1.305 3.495.998.108-.776.417-1.305.76-1.605-2.665-.3-5.466-1.332-5.466-5.93 0-1.31.465-2.38 1.235-3.22-.135-.303-.54-1.523.105-3.176 0 0 1.005-.322 3.3 1.23.96-.267 1.98-.399 3-.405 1.02.006 2.04.138 3 .405 2.28-1.552 3.285-1.23 3.285-1.23.645 1.653.24 2.873.12 3.176.765.84 1.23 1.91 1.23 3.22 0 4.61-2.805 5.625-5.475 5.92.42.36.81 1.096.81 2.22 0 1.606-.015 2.896-.015 3.286 0 .315.21.69.825.57C20.565 22.092 24 17.592 24 12.297c0-6.627-5.373-12-12-12"/></svg>: [justoneapi-mcp](https://github.com/justoneapi-official/justoneapi-mcp)

## 第三方接入：FluxA {#fluxa-access}

部分 JustOneAPI 接口支持通过第三方平台 FluxA 按次调用，供 AI Agent 使用。通过该渠道调用时，无需单独注册 JustOneAPI 账号或自行配置其 API Key。

使用时需要 FluxA 钱包或其支持的其他支付方式。可用接口、价格及支付规则以 FluxA 页面为准。已有 JustOneAPI 账号或官方 MCP 配置的用户，可以继续使用现有接入方式。

👉 [查看 FluxA 支持的接口与接入方式](https://agentmarket.fluxapay.xyz/marketplace/apis/justoneapi)

## 🛠 技术支持与反馈

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

👉 [联系我们](https://justoneapi.com/zh/contact)
