Appearance
2.1.12 权益包信息查询(可选)
获取用户有效期内的权益包列表
- 接口提供方: 流量承接方(KN)
- 接口调用方: 流量提供方
- method: query_equity_list
请求参数
| 参数 | 类型 | 必选 | 说明 | 备注 |
|---|---|---|---|---|
| receiver_user_id | string | N | 流量承接方的用户id | 不超过32位;receiver_user_id&provider_user_id传其中一个即可 |
| provider_user_id | string | N | 流量提供方的用户id | 不超过32位;receiver_user_id&provider_user_id传其中一个即可 |
响应参数
| 参数 | 类型 | 必选 | 说明 | 备注 |
|---|---|---|---|---|
| equity_list | array object | Y | 有效期内的权益包列表 | - |
equity_list.object
| 参数 | 类型 | 必选 | 说明 | 备注 |
|---|---|---|---|---|
| equity_type | string | Y | 权益包类型 | 见 3.1.9 |
| related_id | string | Y | 权益包关联id | 不超过32位; 用信场景:传入receiver_loan_id; 展期场景:传入receiver_extension_id |
| start_timestamp | long | Y | 权益包生效日期的时间戳(秒级) | - |
| end_timestamp | long | Y | 权益包失效日期的时间戳(秒级) | - |
| detail_list | array object | Y | 权益包详情列表 | - |
equity_list.object.detail_list.object
| 参数 | 类型 | 必选 | 说明 | 备注 |
|---|---|---|---|---|
| coupon_id | int | Y | 优惠券id | - |
| category | string | Y | 类目 | - |
| brand | string | Y | 品牌 | - |
| amount | string | Y | 优惠券面值金额(泰铢) | - |
| discount | string | Y | 优惠券折扣金额(泰铢) | - |
| url | string | Y | 优惠劵链接 | - |
请求参数示例
json
{
"receiver_user_id": "87654321"
}响应参数示例
json
{
"code": 0,
"message": "success",
"data": {
"equity_list": [
{
"equity_type": "loan",
"related_id": "M2006010212345678902",
"start_timestamp": 1756885676,
"end_timestamp": 1756885676,
"detail_list": [
{
"coupon_id": 1,
"category": "Camera Accessories",
"brand": "ZZHI shop",
"amount": "130",
"discount": "10",
"url": "https://abc.com/def"
},
{
"coupon_id": 2,
"category": "Camera Accessories",
"brand": "ZZHI shop",
"amount": "130",
"discount": "10",
"url": "https://abc.com/def"
}
]
},
{
"equity_type": "loan",
"related_id": "M2006010212345678901",
"start_timestamp": 1756885676,
"end_timestamp": 1756885676,
"detail_list": [
{
"coupon_id": 1,
"category": "Camera Accessories",
"brand": "ZZHI shop",
"amount": "130",
"discount": "10",
"url": "https://abc.com/def"
},
{
"coupon_id": 2,
"category": "Camera Accessories",
"brand": "ZZHI shop",
"amount": "130",
"discount": "10",
"url": "https://abc.com/def"
}
]
}
]
}
}