推荐日志

分页查询当前用户的所有推荐操作历史。

GET /referral/logs
Authorization: Bearer <token>

查询参数

参数	类型	默认值	说明
page	int	1	页码（最小 1）
page_size	int	20	每页条数（1–100）
action	string	—	按操作类型过滤（可选）

action 可选值

值	说明
create_code	创建推荐码
bind	绑定推荐码
rebind	重新绑定（切换推荐码）
unbind	解绑推荐码
claim	链下领取返佣

响应

{
  "logs": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "action": "create_code",
      "target_address": null,
      "referral_code": "4DDDC2D4",
      "amount": null,
      "old_value": null,
      "new_value": null,
      "created_at": 1772010604000
    },
    {
      "id": "550e8400-e29b-41d4-a716-446655440001",
      "action": "bind",
      "target_address": "0xabc...",
      "referral_code": "4DDDC2D4",
      "amount": null,
      "old_value": null,
      "new_value": null,
      "created_at": 1772020000000
    },
    {
      "id": "550e8400-e29b-41d4-a716-446655440002",
      "action": "claim",
      "target_address": null,
      "referral_code": null,
      "amount": "45.00",
      "old_value": null,
      "new_value": null,
      "created_at": 1772100000000
    }
  ],
  "total": 3,
  "page": 1,
  "page_size": 20
}

响应字段

字段	类型	说明
logs	array	日志列表
logs[].id	string	唯一日志 ID（UUID）
logs[].action	string	操作类型
logs[].target_address	string | null	关联地址（如绑定时的被推荐人地址）
logs[].referral_code	string | null	关联推荐码
logs[].amount	Decimal | null	涉及金额（如领取金额，USDT）
logs[].old_value	string | null	变更前的值（如重新绑定时旧推荐码）
logs[].new_value	string | null	变更后的值（如重新绑定时新推荐码）
logs[].created_at	int64	时间戳（毫秒）
total	int64	匹配记录总数
page	int	当前页码
page_size	int	每页条数

代码示例

Python

import requests

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

# Query referral logs with pagination and optional action filter
resp = requests.get(
    f"{BASE_URL}/referral/logs",
    headers={"Authorization": f"Bearer {JWT_TOKEN}"},
    params={"page": 1, "page_size": 20, "action": "bind"},
)
data = resp.json()

print(f"Total: {data['total']} (Page {data['page']}/{(data['total'] - 1) // data['page_size'] + 1})")
for log in data["logs"]:
    print(f"  [{log['action']}] code={log['referral_code']} addr={log['target_address']} at={log['created_at']}")