Skip to main content
「申请(Application)」表示当前账户对某个服务的订阅关系——必须先申请,才能再为这个申请创建 API 凭证、调用业务接口。首次申请某个服务时,Application 会获得该服务当前配置的 free_amount;该值可能为 0。
ℹ️ 本接口属于 AceDataCloud 平台管理 API,统一前缀 https://platform.acedata.cloud/api/v1/。完整接口索引见获取 AceDataCloud 平台文档列表。

完整的对接流程

新用户从注册到调通第一个业务接口,通常走这 5 步:
  1. 拿到账户令牌 → 管理 AceDataCloud 平台账户令牌
  2. 挑选服务 → 获取 AceDataCloud 平台服务列表
  3. 创建申请(本文档) → 按服务配置获得初始额度
  4. 创建 API 凭证 → 创建 AceDataCloud 平台 API 凭证
  5. 调用业务接口 → 用得到的 32 位 Token 调 https://api.acedata.cloud/<path>

接口概览

鉴权说明(如何获取账户令牌)

请求头:
账户令牌(Account Token)是开发者通过 API 管理自己账户资源的”账号级密钥”。获取方式:
  1. 控制台一键创建(推荐):登录 AceDataCloud 平台 → Account Token 控制台 → 点「创建」即可获得 platform-v1- 开头的令牌。
  2. API 创建:用已有的账户令牌或浏览器登录态 JWT 调用 POST /api/v1/platform-tokens/,详见管理 AceDataCloud 平台账户令牌。
⚠️ 账户令牌与密码同等敏感,禁止写入前端代码或公开仓库。一旦泄露立即在控制台删除并重建。

请求体

请求示例

cURL

Python

Node.js

响应示例

成功(HTTP 201)

返回字段结构与获取 AceDataCloud 平台服务申请详情一致。

已申请过(HTTP 400)

这是设计上的硬限制:每个用户对每个服务只能有一个 Application。已存在时通过获取 AceDataCloud 平台服务申请列表查找现成的。

服务不存在(HTTP 404)

服务需要审核(HTTP 403)

如果服务的 need_verify=true(在服务列表里可看到该字段),需走工单流程申请白名单。

错误处理

错误响应统一格式:

实用提示

  • 创建本身不扣款:首次创建时按服务当前 free_amount 设置初始额度;该值可能为 0,且再次创建同类 Application 不保证重复赠送。
  • 是否需要付费看 paid 字段:刚申请时 paid=false,调用创建 AceDataCloud 平台充值订单 完成支付后变为 true。
  • disabled=true 表示被暂时禁用——比如风控触发、欠费等。被禁用时业务接口会返回 403。
  • 不要无界并发创建:先从分页服务列表取得目标 service_id,再按业务需要逐项申请;遇到 duplication 时复用已有 Application。

相关接口