On this page
验证单个用户藏品
在用户产生交易行为时,对用户之前提交的交易藏品进行有效性验证【必需接口】
请求参数
bizData字段
参数 | 类型 | 是否必填 | 描述 | 示例 |
---|---|---|---|---|
phoneNumber | String | 必须 | 用户注册手机号 | 18888888888 |
collectionId | String | 必须 | 藏品系列id | |
uniqueId | String | 必须 | 藏品唯一id | |
type | String | 可选 | 藏品类型 | 1:藏品(默认值) 2:链游材料 |
count | Integer | 可选 | 藏品数量 | 用户计划转赠的数量,需平台方校验。type=1时为空,type=2时必传 |
bizData数据结构
JSON
{
"phoneNumber": "18888888888",
"collectionId": "10003110", // 藏品系列id
"uniqueId": "1000311009", // 藏品唯一id
"type": "1" // 藏品
}
JSON
{
"phoneNumber": "18888888888",
"collectionId": "10003110", // 材料系列id
"uniqueId": "1000311009", // 材料唯一id
"type": "2", // 材料
"count": 180
}
响应参数
响应字段
参数 | 类型 | 是否必填 | 描述 | 示例 |
---|---|---|---|---|
result | Boolean | 必须 | 验证结果 | |
untradableReason | String | 选填 | 不可转赠原因 |
bizData数据结构(校验通过)
JSON
{
"result": true
}
bizData数据结构(校验不通过)
JSON
{
"result": false,
"untradableReason": "藏品不允许转赠"
}
JSON
{
"result": false,
"untradableReason": "材料数量不够"
}