Accplanet 客户 API 快速入门：列出、检查库存和下单
Accplanet Customer API quick start
Get an API key and call POST /api/v2 to list services, check inventory, place an order, and poll status.
-
Create an API key
Open Profile → API key on Accplanet, generate a key, and store it in a secret environment variable.
-
List services and check stock
POST https://accplanet.com/api/v2 with action=services (cache results), then action=inventory for target service IDs.
-
Place order and poll status
POST action=add with service and quantity, then poll action=status with the returned order id. Honor HTTP 429 Retry-After.
如果你通过 Accplanet 以编程方式购买，你不需要为每个操作使用不同的 URL。Accplanet Customer API 使用一个端点——POST https://accplanet.com/api/v2——外加一个 action 参数。本指南是一份实用的快速入门，让经销商或自动化程序能够一次性完成列出目录项、检查库存、下单和轮询状态。
Accplanet 是一个供应商市场。Customer API 面向已经拥有余额的买家和经销商。完整的参数表位于 Customer API 文档中；本文聚焦于最短的可用路径。
简而言之
- 在你的 Accplanet 个人资料中创建一个 API 密钥，并像对待密码一样妥善保管。
- 使用
key+action（表单字段或 JSON）调用POST https://accplanet.com/api/v2。 - 典型的经销商循环：
services→inventory→add→status（可选balance）。 - 缓存目录读取结果。将 HTTP 429 +
Retry-After视为必须的退避，而非可选的提示。 - 使用本文快速完成集成；使用官方文档了解每个字段。
获取你的 API 密钥
登录后，打开个人资料 → API 密钥，并生成一个 API 密钥。将其复制一次到密钥管理器或环境变量中（例如 ACCPLANET_API_KEY）。每次 Customer API 调用都通过在请求体中以 key（别名 apikey）传递该密钥进行身份验证。
{
"key": "YOUR_API_KEY",
"action": "categories"
}你也可以使用 curl -d 发送表单编码字段。优先使用环境变量，而非硬编码字符串。
API 设计原则（为什么只有一个端点）
Accplanet 的 Customer API 遵循一些实用的API 设计原则，使经销商集成更简单：
- 单一入口点：一个 URL，多个
action值——需要配置的基础 URL 更少。 - 显式认证：API 密钥随每个请求传递；脚本无需不透明的会话 cookie。
- 动作词汇表：
services、inventory、add、status、balance及相关动作清晰地映射到目录 → 库存 → 下单 → 轮询。 - 稳定的错误结构：失败的调用返回结构化错误；速率限制使用 HTTP 429。
正是这种设计使得最小客户端通常只是一个薄封装：设置密钥、选择动作、解析 JSON。
集成阶梯
1 · 冒烟测试
列出分类
在接入下单逻辑之前，先确认密钥可用。
curl -X POST https://accplanet.com/api/v2 \
-d "key=YOUR_API_KEY" \
-d "action=categories"2 · 目录
拉取服务（产品）
使用 action=services 进行 Accplanet 服务 API / 目录同步。优先使用较大的 limit（最高 500），并在本地缓存响应至少 60–120 秒。这是经销商首次遇到速率限制的动作。
curl -X POST https://accplanet.com/api/v2 \
-d "key=YOUR_API_KEY" \
-d "action=services" \
-d "limit=100"3 · 库存
在下单前检查库存
对于检查库存 API 路径，使用你关心的服务 ID 调用 action=inventory。当缓存中库存已为零时，跳过盲目的 add 调用。
curl -X POST https://accplanet.com/api/v2 \
-d "key=YOUR_API_KEY" \
-d "action=inventory" \
-d "services=10042"4 · 下单
下单，然后轮询状态
下单 API：使用 service 以及可选的 quantity / link 调用 action=add。然后使用返回的订单 ID 通过 action=status 进行轮询。不要每秒轮询状态。
curl -X POST https://accplanet.com/api/v2 \
-d "key=YOUR_API_KEY" \
-d "action=add" \
-d "service=10042" \
-d "quantity=1"
curl -X POST https://accplanet.com/api/v2 \
-d "key=YOUR_API_KEY" \
-d "action=status" \
-d "order=ORDER_ID"会破坏首次集成的速率限制
经过身份验证的 Customer API 流量受突发、全局和按动作配额的限制。经销商 API 集成的实用规则：
- 缓存
services；按计划刷新（通常 2–5 分钟），而不是每次页面浏览都刷新。 - 每个 API 密钥只用一个调度器——避免三个 cron 任务同时同步同一目录。
- 遇到 HTTP 429 时，休眠
Retry-After秒，然后带退避重试一次。
确切数字可能会变化；以文档和 429 响应为准。
买家检查清单
- API 密钥存储在密钥管理器中，而非 git 中。
- 冒烟测试
categories返回数据。 - 目录同步使用
services+ 本地缓存。 - 下单先使用
inventory，再add，然后缓慢轮询status。 - 在生产流量之前实现 429 处理程序。
常见问题
表单请求体还是 JSON？
Customer API v2 两者都支持。与你的 HTTP 客户端能干净发送的格式保持一致；每次调用都保留 key 和 action。
完整的动作列表在哪里？
参见 https://accplanet.com/en/api-docs/user/——本快速入门仅涵盖顺利路径。
在 inventory 返回可用后，Accplanet 能保证库存吗？
不能。市场上的库存变化很快。在重要时重新检查，并优雅地处理订单错误。
