客户API快速入门：在一个循环中集成Accplanet /api/v2

如果您以编程方式在 Accplanet 上购买，则无需为每个操作使用不同的 API。客户 API 使用一个端点 — POST https://accplanet.com/api/v2 — 以及一个 action 参数。本指南是一个实用的快速入门，让开发人员可以在一次会话中列出目录项、检查库存、下订单并轮询状态。

Accplanet 是一个供应商聚合市场。供应商履行库存；Accplanet 提供发现、结账、订单跟踪和支持。仅将 API 用于合法的订单管理。完整参考：客户 API 文档。

认证和端点

从您的 Accplanet 个人资料 API 密钥页面创建或复制您的客户 API 密钥，然后调用：

POST https://accplanet.com/api/v2

{
  "key": "YOUR_API_KEY",
  "action": "categories"
}

支持的操作：categories、shops、services、inventory、add、status、balance。

集成阶梯

在继续之前，请确保每个步骤都返回干净的响应。

复制粘贴 curl 示例

# 余额
curl -X POST https://accplanet.com/api/v2 -d "key=YOUR_API_KEY" -d "action=balance"

# 服务页面
curl -X POST https://accplanet.com/api/v2 \
  -d "key=YOUR_API_KEY" -d "action=services" -d "page=1" -d "limit=50"

# 库存
curl -X POST https://accplanet.com/api/v2 \
  -d "key=YOUR_API_KEY" -d "action=inventory" -d "service=10042"

# 添加订单
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=YOUR_ORDER_ID"

将占位符替换为您的密钥、来自 services 的真实 service 以及 add 返回的 order。从低成本测试项目的数量 1 开始。

错误和速率限制

• 无效凭据 → HTTP 401，带有 {"error":"Invalid API key"}。
• 验证 / 库存 / 余额问题 → 通常为 HTTP 400，带有单个 error 字符串（例如库存不足或余额不足）。
• 速率限制 → HTTP 429，带有 Retry-After。退避并重试。
• 分页时默认服务页面大小为 50；仅在有意获取完整列表时使用 limit=0。

定价、库存和可用性随实时列表而变化。在自动购买之前始终重新读取 services / inventory。

买家清单

• [ ] API 密钥存储在服务器密钥管理器中
• [ ] balance 足以支付一个小型测试订单
• [ ] 选择了 available=true 的 service
• [ ] 数量在 min/max 范围内
• [ ] 持久化了 add 返回的 order ID 并轮询 status
• [ ] 在代码中处理了 429 和钱包错误

下一步：打开客户 API 文档，运行一次测试 API，然后将相同的操作接入您的后端。集成目录同步的供应商应阅读 Accplanet 博客上的配套供应商指南。

常见问题