查询 AceDataCloud 平台分销推广信息

返回当前账户的分销（联盟营销 / Affiliate）数据——包括分销专属链接、邀请的下级用户数、累计佣金、可提现余额、近期成交记录等。

适用场景：

在你自己的产品里嵌入「赚取佣金」面板。
自动化邀请脚本、邀请仪表盘。
月度结算时拉取明细。

ℹ️ 本接口属于 AceDataCloud 平台管理 API，统一前缀 https://platform.acedata.cloud/api/v1/。

接口概览

项	内容
方法	`GET`
URL	`https://platform.acedata.cloud/api/v1/distribution/`
鉴权	✅ 需要账户令牌

鉴权说明（如何获取账户令牌）

请求头：

1	Authorization: Bearer platform-v1-92eb****629c

获取方式：登录 AceDataCloud 平台 → Account Token 控制台 → 点「创建」按钮。详见管理 AceDataCloud 平台账户令牌。

请求示例

cURL

1
2
3

curl 'https://platform.acedata.cloud/api/v1/distribution/' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer platform-v1-92eb****629c'

Python

import requests

resp = requests.get(
    "https://platform.acedata.cloud/api/v1/distribution/",
    headers={"authorization": "Bearer platform-v1-92eb****629c"},
    timeout=10,
)
data = resp.json()
print(f"专属推广链接: {data['referral_url']}")
print(f"邀请的用户数: {data['referred_users_count']}")
print(f"累计佣金: ¥{data['total_commission']}")
print(f"可提现余额: ¥{data['withdrawable_balance']}")

Node.js

const r = await fetch('https://platform.acedata.cloud/api/v1/distribution/', {
  headers: { authorization: 'Bearer platform-v1-92eb****629c' },
})
console.log(await r.json())

响应示例（HTTP 200）

{
  "user_id": "89518d07-5560-4b05-92c1-667f3ddf6a4b",
  "referral_code": "ABC123XYZ",
  "referral_url": "https://platform.acedata.cloud/?ref=ABC123XYZ",
  "referred_users_count": 87,
  "active_users_count": 31,
  "commission_rate": 0.20,
  "total_commission": 4521.30,
  "withdrawable_balance": 1820.50,
  "pending_balance": 124.30,
  "withdrawn_total": 2576.50,
  "currency": "CNY",
  "recent_orders": [
    {
      "order_id": "fa927d12-...",
      "referred_user_id": "uuser-abc...",
      "amount": 63.2,
      "commission": 12.64,
      "paid_at": "2026-04-25T15:23:00Z"
    }
  ],
  "tier": "Standard",
  "next_tier_at": 10000,
  "all_tiers": [
    { "name": "Standard",   "min_commission": 0,     "commission_rate": 0.20 },
    { "name": "Pro",        "min_commission": 1000,  "commission_rate": 0.25 },
    { "name": "Enterprise", "min_commission": 10000, "commission_rate": 0.30 }
  ]
}

响应字段说明

字段	类型	说明
`user_id`	UUID	当前用户 ID
`referral_code`	string	专属推广码
`referral_url`	string	完整推广链接（含 `?ref=` 参数）
`referred_users_count`	integer	已通过此链接注册的用户总数
`active_users_count`	integer	其中曾有付费行为的活跃用户数
`commission_rate`	number	当前佣金率（已结算订单按此比例分成）
`total_commission`	number	累计佣金（含已提现、可提现、待结算）
`withdrawable_balance`	number	当前可立即提现的余额
`pending_balance`	number	待结算余额（订单 3 天后转入可提现）
`withdrawn_total`	number	历史已提现总额
`currency`	string	结算货币代码
`recent_orders`	array	近期带分销关系的订单（最多 20 条），含 `order_id` / `referred_user_id` / `amount` / `commission`
`tier`	string	当前推广等级
`next_tier_at`	number	达到下一级所需累计佣金
`all_tiers`	array	全部等级定义

错误处理

HTTP	code	含义
401	`not_authenticated`	缺少账户令牌
403	`not_enabled`	你的账户尚未开通分销功能（联系客服开通）

实用提示

3 天结算锁定期：被邀请用户付费后，佣金先进 pending_balance，3 天后无退款则转入 withdrawable_balance。
多级分销：默认只支持一级（邀请的用户付费才有佣金）。多级分销请联系客服开通企业版。
提现：在 AceDataCloud 平台分销中心手动发起提现，支持支付宝、银行卡、USDT。
推广素材：去分销中心下载海报、Banner、邮件模板。

静觅崔庆才的个人站点 - Python爬虫教程

查询 AceDataCloud 平台分销推广信息

接口概览

鉴权说明（如何获取账户令牌）

请求示例

cURL

Python

Node.js

响应示例（HTTP 200）

响应字段说明

错误处理

实用提示

相关接口