推荐状态

返回用户作为推荐人（Referrer）和被推荐人（Referee）的双向状态。

GET /referral/status
Authorization: Bearer <token>

响应

{
  "as_referrer": {
    "has_code": true,
    "code": "4DDDC2D4",
    "code_created_at": 1772010604000,
    "total_referrals": 3,
    "referees": [
      {
        "address": "0xabc...",
        "bound_at": 1770000000000
      }
    ]
  },
  "as_referee": {
    "is_bound": false,
    "referrer_address": null,
    "referrer_code": null,
    "bound_at": null
  }
}

响应字段

as_referrer

字段	类型	说明
has_code	bool	是否已创建推荐码
code	string | null	推荐码（8 位大写十六进制）
code_created_at	int64 | null	创建时间（毫秒时间戳）
total_referrals	int64	累计推荐人数
referees	array	被推荐人列表（最近 50 位）
referees[].address	string	被推荐人钱包地址
referees[].bound_at	int64	绑定时间（毫秒时间戳）

as_referee

字段	类型	说明
is_bound	bool	是否已绑定推荐码
referrer_address	string | null	推荐人地址
referrer_code	string | null	绑定的推荐码
bound_at	int64 | null	绑定时间（毫秒时间戳）

代码示例

Python

import requests

BASE_URL = "https://api.ztdx.io"
JWT_TOKEN = "your_jwt_token"

resp = requests.get(
    f"{BASE_URL}/referral/status",
    headers={"Authorization": f"Bearer {JWT_TOKEN}"},
)
data = resp.json()

# As referrer
ref = data["as_referrer"]
if ref["has_code"]:
    print(f"Referral code: {ref['code']}, Total referrals: {ref['total_referrals']}")
    for r in ref["referees"]:
        print(f"  Referee: {r['address']}")

# As referee
referee = data["as_referee"]
if referee["is_bound"]:
    print(f"Bound to: {referee['referrer_code']} ({referee['referrer_address']})")