获取活动奖励列表(Beta)
可以获取活动奖励列表,仅支持返回奖品库奖品
调用方式
- 请求方式:
POST - 请求地址:
https://tls2s.allapp.link/manage/campaign/campaign_reward_list?project_id=你的ProjectId
请求头参数(Header)
| 参数 | 必须 | 值 | 说明 |
|---|---|---|---|
| Content-Type | 是 | application/json | 声明json格式 |
| Authorization | 是 | Bearer md5(OpenSecret+(空格)+md5(请求body)) | OpenSecret 获取方式:Dashboard > 开发配置 > 开放平台秘钥 获取OpenSecret |
请求内容参数(Body)
请求示例:
{
"campaign_id": "csbhkerdj7t9ls7gvb0",
"start": 1729492992,
"end": 1729579392,
"page": 1,
"page_size": 1000
}参数说明
| 参数 | 必须 | 类型 | 说明 |
|---|---|---|---|
| project_id | 是 | string | 项目id |
| campaign_id | 是 | string | 活动id |
| start | 否 | number | 开始时间戳(单位:秒) |
| end | 否 | number | 结束时间戳(单位:秒) |
| page | 否 | number | 第几页(最小填 1) |
| page_size | 否 | number | 每页数量(不超过 1,000) |
返回示例
{
"code": 200,
"msg": "请求成功",
"data": {
"list": [
{
"campaign_id": "csbhkerdj7t9ls7gvb0",
"reward_hash_id": "2465898765467473827",
"sub_user_id": "user_123456",
"created_date": "2024-10-22 13:12:12",
"updated_date": "2024-10-22 13:12:12",
"title": "奖品标题",
"status": 1,
"fail_msg": "",
"dy_reward_type": 1,
"custom_reward_val": "EXCHANGE-CODE-001",
"receive_type": 1,
"reward_num": 1,
"contact": "support@example.com",
"kv_data": [
{
"key": "key1",
"value": "value1"
}
],
"form": {
"title": "收货信息",
"items": [
{
"key": "name",
"value": "张三"
}
]
}
}
],
"total": 1
}
}返回参数说明
| 参数 | 类型 | 说明 |
|---|---|---|
| code | int32 | 返回状态码,200 为成功返回 |
| msg | string | 返回状态码信息 |
| data | object | 返回内容 |
| data.list | array(object) | 列表数据 |
| data.list.campaign_id | string | 活动id |
| data.list.reward_hash_id | string | 奖品 hash_id |
| data.list.sub_user_id | string | 用户 ID |
| data.list.created_date | string | 奖励时间 |
| data.list.updated_date | string | 数据最后更新时间 |
| data.list.title | string | 奖品标题 |
| data.list.status | number | 奖品状态(1-发送成功,2-待发送,3-发送失败,4-手动发放,5-待填写表单,6-已填写表单) |
| data.list.fail_msg | string | 失败具体原因说明 |
| data.list.dy_reward_type | number | 动态奖品内容类型(0-无,1-兑换码) |
| data.list.custom_reward_val | string | 自定义的奖品值 |
| data.list.child_title | string | 子活动标题 |
| data.list.receive_type | number | 发放类型(1-系统发放,2-联系客服,3-客户端发奖,4-提交表单) |
| data.list.reward_num | number | 奖品数量 |
| data.list.contact | string | 联系方式 |
| data.list.kv_data | array(object) | 键值数据 |
| data.list.kv_data.key | string | 键 |
| data.list.kv_data.value | string | 值 |
| data.list.form | object | 表项 |
| data.list.form.title | string | 表单标题 |
| data.list.form.items | array(object) | 表单项 |
| data.list.form.items.key | string | 表单项标题(显示在表单中) |
| data.list.form.items.value | string | 表单项填写的值 |
| data.total | number | 列表总数 |