NFT 领取历史接口文档

接口信息

• 接口路径: /api/earn/nft-claim-history
• 请求方法: GET
• 接口描述: 获取 NFT 领取历史记录列表，支持分页查询

请求参数

Query 参数

参数名	类型	必填	说明
pageIndex	number	否	页码，从 1 开始，默认为 1
pageSize	number	否	每页数量，默认值根据接口实现而定
walletAddress	string	否	钱包地址，用于查询指定用户的领取历史

请求示例

GET /api/earn/nft-claim-history?pageIndex=1&pageSize=20&walletAddress=0x35487e65c8aef497fa8f29cbe9cb097c88753eb8172c0f640285921169730d38

响应数据结构

响应格式

{
  "code": 200,
  "message": "OK",
  "result": {
    "data": [
      {
        "user": "0x1234...5678",
        "walletAddress": "0x35487e65c8aef497fa8f29cbe9cb097c88753eb8172c0f640285921169730d38",
        "timestamp": 1764909625554,
        "txHash": "0x76pa6dVNLi8b99aZsF43MnHoGvVA4aspLLoEdBQCnqZg"
      }
    ],
    "nextPageIndex": 2,
    "total": 200
  }
}

响应字段说明

result 对象字段

字段名	类型	必填	说明
data	array	是	NFT 领取历史记录列表
nextPageIndex	number	否	下一页页码，无下一页为空
total	number	是	总记录数

data 数组项字段

字段名	类型	必填	说明
user	string	是	用户地址（省略格式）
walletAddress	string	是	钱包地址（完整格式）
timestamp	number	是	领取时间戳（毫秒）
txHash	string	否	交易哈希

响应示例

{
  "code": 200,
  "message": "OK",
  "result": {
    "data": [
      {
        "user": "0x1234...5678",
        "walletAddress": "0x35487e65c8aef497fa8f29cbe9cb097c88753eb8172c0f640285921169730d38",
        "timestamp": 1764909625554,
        "txHash": "0x76pa6dVNLi8b99aZsF43MnHoGvVA4aspLLoEdBQCnqZg"
      },
      {
        "user": "0xabcd...efgh",
        "walletAddress": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
        "timestamp": 1764822220000,
        "txHash": "0xGTztvWbGPRCau1cbfyATvmPKBSu7gAW2UwuQ4oQ8VHYf"
      }
    ],
    "nextPageIndex": 2,
    "total": 200
  }
}

注意事项

1. pageIndex 从 1 开始计数
2. pageSize 为可选参数，默认值根据接口实现而定
3. walletAddress 参数为可选，传入后可以查询指定用户的领取历史
4. 当 nextPageIndex 不存在或为空时，表示没有下一页数据
5. total 字段表示符合条件的总记录数，可用于计算总页数
6. timestamp 为时间戳（毫秒），前端需要转换为可读的时间格式
7. user 字段为省略格式（如 "0x1234...5678"），walletAddress 为完整地址
8. txHash 字段可能为空或不存在，前端需要做兼容处理
9. 响应格式遵循 API 标准：code 为 200 表示成功，message 为状态消息
10. 数据按时间戳降序排列（最新的记录在前）