Appearance
获取直播间任务详情
| 拥有此API的权限集 |
|---|
| 直播管理-查询 |
请求方式及url
- 请求方式：
POST - 请求头：
Content-Type:application/json - 接口地址：
https://api.xiaoe-tech.com/xe.alive.marketing.task.get/1.0.0 - 频率限制：
10秒50次
接口调试
请求参数
响应结果
暂无响应数据
请求参数
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| access_token | 是 | string | 专属token |
| alive_id | 是 | string | 直播ID |
| live_task_id | 是 | int | 任务ID |
请求示例
json
{
"access_token": "xe_xxxxx",
"alive_id": "l_xxxxx",
"live_task_id": 1381858
}返回参数
|参数名|必选|类型|说明|备注 |:----- |:----|:---------|:-----| | |code |是|int |返回码 |0-成功，其他失败| |msg |是 |string | 返回信息 |...| |request_id |是 |string | 请求ID |...| |data |是 |json对象 | 返回值 |...|
data.live_task 对象
| 参数名 | 类型 | 说明 |
|---|---|---|
| id | int | 任务ID |
| alive_id | string | 直播ID |
| task_type | int | 任务类型：1=观看任务，2=互动任务，3=消费任务，4=活跃任务 |
| task_condition | string | 任务条件：观看任务时填写具体分钟值，互动任务时：1-评论 2-分享（21分享拉人，22分享拉新） 3-点赞，消费任务时：4-下单笔数 5-消费金额，活跃任务时：6-打赏 7-投票 8-问卷 9-签到 10-答题 |
| task_content | string | 任务内容 |
| task_state | int | 任务状态:0-已删除,1-正常，2-已停止 |
| reward_type | int | 奖励类型：1=积分，2=优惠券，3=红包，4=课程/商品，5=自定义奖品 |
| reward_value | object | 奖励值配置 |
| reward_frequency | string | 奖励发放频率 |
| start_at | string | 开始时间 |
| end_at | string | 结束时间 |
| reward_pay_type | int | 奖励发放方式 |
| team_pay_config | string | 团队支付配置 |
| task_module | int | 任务模块：0-单项任务，1-组合任务 |
| task_is_major | int | 是否主任务：0-是，1-否 |
| task_title | string | 任务标题 |
| is_order | int | 是否按顺序完成：0-否，1-是 |
| child_tasks | string | 子任务，组合任务时为JSON字符串 |
| coupon_list | object | 优惠券列表 |
| level_member_rank | array | 等级会员条件 |
| rule_type | int | 规则类型 |
| rule_config | object | 规则配置 |
组合任务说明：
task_module=1表示组合任务is_order=0表示无序组合任务：主任务有统一的奖励配置（reward_type有值），子任务无单独奖励is_order=1表示有序组合任务：主任务无奖励（reward_type=0），每个子任务可单独设置奖励
reward_value 对象（自定义奖品配置）
| 参数名 | 类型 | 默认值 | 取值说明 | 备注说明 |
|---|---|---|---|---|
| defaultImg | int | 1 | 固定为1（代表使用默认图片） | 无特殊配置时无需修改 |
| prizeCusTomTitle | string | 空 | 奖品自定义标题 | 无自定义标题时留空 |
| prizeHint | string | - | 用户获奖后的提示语 | 可自定义（如"恭喜中奖！"） |
| prizeImg | string | - | 奖品展示图片的URL地址 | 需填写有效的图片链接 |
| prizeName | string | - | 奖品名称 | 示例："一等奖-保温杯" |
| prizeNum | int | 1 | 奖品数量 | 可根据实际配置调整 |
| qrcode | string | 1 | 是否显示兑奖二维码：0=不显示 1=显示 | 核心配置，控制二维码展示 |
| qrcodeImg | string | - | 兑奖二维码图片的URL地址 | qrcode=1时需填写有效链接 |
| string | 0 | 是否显示商家微信号：0=不显示 1=显示 | 无需展示时保持0即可 | |
| wechatNum | string | 空 | 商家微信号 | wechat=1时需填写对应内容 |
返回示例
json
{
"code": 0,
"msg": "ok",
"request_id": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"data": {
"live_task": {
"id": 1381858,
"alive_id": "l_xxxxx",
"task_type": 2,
"task_condition": "1",
"task_content": null,
"task_state": 1,
"reward_type": 5,
"is_show_answer": 0,
"answer_chance": 0,
"reward_value": {
"defaultImg": 1,
"prizeCusTomTitle": "",
"prizeHint": "恭喜您，获得奖品",
"prizeImg": "https://example.com/image/prize.png",
"prizeName": "奖品名称",
"prizeNum": 1,
"qrcode": "1",
"qrcodeImg": "https://example.com/image/qrcode.png",
"wechat": "0",
"wechatNum": ""
},
"reward_frequency": "",
"start_at": "2026-02-27 00:00:00",
"end_at": "2026-02-28 00:00:00",
"reward_pay_type": 0,
"team_pay_config": "",
"task_module": 0,
"task_is_major": 0,
"task_title": "",
"is_order": 0,
"child_tasks": "",
"coupon_list": null,
"level_member_rank": null,
"rule_type": 0,
"rule_config": null
}
}
}组合任务返回示例
无序组合任务（is_order=0）
主任务有统一的奖励配置，子任务无单独奖励
json
{
"code": 0,
"msg": "ok",
"request_id": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"data": {
"live_task": {
"id": 1381840,
"alive_id": "l_xxxxx",
"task_type": 0,
"task_condition": "",
"task_content": null,
"task_state": 1,
"reward_type": 5,
"is_show_answer": 0,
"answer_chance": 0,
"reward_value": {
"defaultImg": 1,
"prizeCusTomTitle": "",
"prizeHint": "恭喜您，获得奖品",
"prizeImg": "https://example.com/image/prize.png",
"prizeName": "奖品名称",
"prizeNum": 1,
"qrcode": "1",
"qrcodeImg": "https://example.com/image/qrcode.png",
"wechat": "0",
"wechatNum": ""
},
"reward_frequency": "",
"start_at": "2026-02-27 00:00:00",
"end_at": "2026-02-28 00:00:00",
"reward_pay_type": 0,
"team_pay_config": "",
"task_module": 1,
"task_is_major": 0,
"task_title": "任务包",
"is_order": 0,
"child_tasks": "[{\"id\":1381841,\"task_type\":1,\"task_condition\":\"10\",\"task_state\":1,\"reward_type\":0,\"reward_value\":\"\"},{\"id\":1381842,\"task_type\":4,\"task_condition\":\"9\",\"task_state\":1,\"reward_type\":0,\"reward_value\":\"\",\"reward_frequency\":\"1\"}]",
"coupon_list": null,
"level_member_rank": null,
"rule_type": 0,
"rule_config": null
}
}
}有序组合任务（is_order=1）
主任务无奖励，每个子任务可单独设置奖励
json
{
"code": 0,
"msg": "ok",
"request_id": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"data": {
"live_task": {
"id": 1381837,
"alive_id": "l_xxxxx",
"task_type": 0,
"task_condition": "",
"task_content": null,
"task_state": 1,
"reward_type": 0,
"is_show_answer": 0,
"answer_chance": 0,
"reward_value": "",
"reward_frequency": "",
"start_at": "2026-02-28 00:00:00",
"end_at": "2026-03-01 00:00:00",
"reward_pay_type": 0,
"team_pay_config": "",
"task_module": 1,
"task_is_major": 0,
"task_title": "任务包",
"is_order": 1,
"child_tasks": "[{\"id\":1381838,\"task_type\":1,\"task_condition\":\"10\",\"task_state\":1,\"reward_type\":5,\"reward_value\":{\"defaultImg\":1,\"prizeCusTomTitle\":\"\",\"prizeHint\":\"恭喜您，获得奖品\",\"prizeImg\":\"https://example.com/image/prize1.png\",\"prizeName\":\"奖品1\",\"prizeNum\":1,\"qrcode\":\"1\",\"qrcodeImg\":\"https://example.com/image/qrcode1.png\",\"wechat\":\"0\",\"wechatNum\":\"\"}},{\"id\":1381839,\"task_type\":4,\"task_condition\":\"9\",\"task_state\":1,\"reward_type\":5,\"reward_value\":{\"defaultImg\":1,\"prizeCusTomTitle\":\"\",\"prizeHint\":\"恭喜您，获得奖品\",\"prizeImg\":\"https://example.com/image/prize2.png\",\"prizeName\":\"奖品2\",\"prizeNum\":1,\"qrcode\":\"1\",\"qrcodeImg\":\"https://example.com/image/qrcode2.png\",\"wechat\":\"0\",\"wechatNum\":\"\"},\"reward_frequency\":\"1\"}]",
"coupon_list": [],
"level_member_rank": null,
"rule_type": 0,
"rule_config": null
}
}
}