盯链开放平台On this page
获取用户藏品列表
获取用户在一级平台持有的藏品列表【必需接口】
请求参数
bizData字段
| 参数 | 类型 | 是否必填 | 描述 | 示例 |
|---|---|---|---|---|
| phoneNumber | String | 必须 | 用户注册手机号 | 18888888888 |
| pageNum | Integer | 必须 | 页码 | 0:第一页 |
| keyword | String | 选填 | 关键字 用于筛选 | 创世 |
| collectionId | String | 选填 | 藏品id 用于筛选 | |
| type | String | 选填 | 藏品类型 用于筛选 1:藏品（默认值） 2:链游材料 |
- 本接口建议分页，一页20条。
- 若不分页时，请在 pageNum > 0 时响应空的 collectionList ，以表示没有第二页 。
bizData数据结构
JSON
{
"pageNum": 0,
"phoneNumber": "18888888888",
"keyword": "创世",
"collectionId": "QlxFptif0S",
"type": "1"
}
响应参数
bizData字段
| 参数 | 类型 | 是否必填 | 描述 | 示例 |
|---|---|---|---|---|
| collectionList | Collection[] | 必须 | 藏品列表 |
collectionList字段
| 参数 | 类型 | 是否必填 | 描述 | 示例 |
|---|---|---|---|---|
| collectionId | String | 必须 | 藏品系列id | |
| uniqueId | String | 必须 | 藏品唯一id | |
| collectionNo | String | 可选 | 藏品编号 | 99 |
| collectionName | String | 必须 | 藏品名 | |
| collectionImageUrl | String | 必须 | 藏品图片地址 | |
| type | String | 可选 | 藏品类型 | 1:藏品（默认值） 2:链游材料 |
| count | Integer | 可选 | 藏品数量 | 用户拥有的数量，type=2时必填 |
| isTradable | Boolean | 必须 | 是否可转赠 | |
| untradableReason | String | 可选 | 不可转赠原因 | 未到可转赠时间 |
| releaseAt | Long | 可选 | 可转赠时间 | 1668931067000 |
uniqueId 解释
例如1，每个uniqueId在当前藏品下唯一：
藏品《创世空投》发行了100份，collectionId为'chaungshi'，100份的uniqueId依次为'001'、'002'、'003' ... '100'。例如2，每个uniqueId在全系统中唯一：
藏品《粉色小熊》发行了100份，collectionId为'tif5DcP6uw'，100份的uniqueId依次为'QlxFptif0S'、'FptiQlxf0S'、'N2KzgthsE1' ... 'KzgN2tE1hs'。collectionNo 解释
当一级平台藏品的编号会影响出价时，盯链中会展示此字段并参与排序。
bizData数据结构
JSON
{
"collectionList": [
{
"collectionId": "100032",
"uniqueId": "100032109",
"collectionName": "藏品A",
"collectionImageUrl": "https://app.dingstock.top/logo.png",
"type": "1", // 藏品
"isTradable": true
},
{
"collectionId": "100032",
"uniqueId": "100032110",
"collectionName": "藏品A",
"collectionImageUrl": "https://app.dingstock.top/logo.png",
"type": "1", // 藏品
"isTradable": false,
"untradableReason": "未到可转赠时间",
"releaseAt": 1668931067000
},
{
"collectionId": "300033",
"uniqueId": "300021231",
"collectionName": "材料A",
"collectionImageUrl": "https://app.dingstock.top/logo.png",
"type": "2", // 材料
"count": 120, // 用户持有材料数量
"isTradable": true
}
]
}