盯链开放平台On this page
单个藏品转赠申请
向一级平台申请转赠藏品【必需接口】
tip
该接口为申请接口，响应结果也为申请状态，转赠是否成功以回调或转赠状态确认接口为准
请求参数
bizData字段
| 参数 | 类型 | 是否必填 | 描述 | 示例 |
|---|---|---|---|---|
| orderId | String | 必须 | 盯链订单号 | |
| buyerPhoneNumber | String | 必须 | 接收人（买家）注册手机号 | 18888888888 |
| sellerPhoneNumber | String | 必须 | 转让人（卖家）注册手机号 | 13888888888 |
| collectionId | String | 必须 | 藏品系列id | |
| uniqueId | String | 必须 | 藏品唯一id | |
| type | String | 可选 | 藏品类型 | 1:藏品（默认值） 2:链游材料 |
| count | Integer | 可选 | 藏品数量 | 用户申请转赠的数量，type=1时为空，type=2时必传 |
bizData数据结构
JSON
// 藏品
{
"orderId": "2020091512301120923",
"buyerPhoneNumber": "18888888888",
"sellerPhoneNumber": "13888888888",
"collectionId": "10003110",
"uniqueId": "1000311009",
"type": "1" // 藏品
}
JSON
// 材料
{
"orderId": "2020091512301120923",
"buyerPhoneNumber": "18888888888",
"sellerPhoneNumber": "13888888888",
"collectionId": "10003110",
"uniqueId": "1000311009",
"type": "2", // 材料
"count": 120
}
响应参数
响应字段
| 参数 | 类型 | 是否必填 | 描述 | 示例 |
|---|---|---|---|---|
| resultCode | String | 必须 | 申请结果 | -1 失败，1 成功 |
| outOrderId | String | 选填 | 一级平台的订单号 | |
| failedReason | String | 选填 | 失败原因 |
bizData数据结构（申请成功）
JSON
{
"resultCode": "1",
"outOrderId": "2020091512301120923"
}
bizData数据结构（申请失败，取消订单）
JSON
{
"resultCode": "-1",
"failedReason": "藏品已不支持转赠",
}