由于活动答题完整的信息字段会比较多,在一些用户量大的场景下,用户请求量会很大。为了加速页面请求到渲染的时间,详情信息分为多个接口提供,根据具体的应用场景来调用。活动的信息都是通过缓存中读取,管理端修改之后会自动更新缓存。
基础信息
用户答题名称、答题状态、答题轮播图等基础信息。
请求方法:GET
是否鉴权:否
请求编码:Content-Type:application/x-www-form-urlencoded
响应编码:Content-Type:application/json;charset=UTF-8
请求地址:index/activity.activity/basicInfo
请求参数:
参数名 | 参数类型 | 是否必填 | 参数说明 | 示例值 |
---|---|---|---|---|
uid | string | 是 | 活动id |
- 成功示例:
{
"data": {
"banner": [
"https://www.tutudati.com/1061.jpg",
],
"cover": "https://www.tutudati.com/1061.jpg",
"title": "国庆知识大挑战:庆祝祖国华诞,答题赢荣耀",
"start_time": "2024-09-16 00:00:00",
"end_time": "2024-11-16 00:00:00",
"is_state": 1,
"state_title": "该活动进行中"
},
"code": 100,
"msg": "请求成功"
}
参数名 | 参数类型 | 是否必有 | 参数说明 | 示例值 |
---|---|---|---|---|
title | string | 是 | 活动名称 | |
cover | string | 是 | 活动封面图 | |
banner | array | 是 | 轮播图数组 | |
start_time | string | 是 | 活动开始时间 | |
end_time | string | 是 | 活动结束时间 | |
state_title | string | 是 | 活动状态提示 | |
is_state | int | 是 | 活动状态值 | 1未开始2进行中3已结束4已取消 |
- 失败示例:
{
"code": 101,
"data": [],
"msg": "请求失败"
}
活动说明
该接口用户获取活动的说明,由于是一个富文本格式的内容,减少对带宽的使用,因此单独提供一个接口使用。
请求方法:GET
是否鉴权:否
请求编码:Content-Type:application/x-www-form-urlencoded
响应编码:Content-Type:application/json;charset=UTF-8
请求地址:index/activity.activity/activityDescContent
请求参数:
参数名 | 参数类型 | 是否必填 | 参数说明 | 示例值 |
---|---|---|---|---|
uid | string | 是 | 活动id |
- 成功示例:
{
"data": {
"content": "<p style=\"line-height: 2em;\">活动详细说明</p>"
},
"code": 100,
"msg": "请求成功"
}
参数名 | 参数类型 | 是否必有 | 参数说明 | 示例值 |
---|---|---|---|---|
content | string | 是 | 活动说明 |
- 失败示例:
{
"code": 101,
"data": [],
"msg": "请求失败"
}
兑奖说明
该接口用户获取活动的兑奖说明,由于是一个富文本格式的内容,减少对带宽的使用,因此单独提供一个接口使用。
请求方法:GET
是否鉴权:否
请求编码:Content-Type:application/x-www-form-urlencoded
响应编码:Content-Type:application/json;charset=UTF-8
请求地址:index/activity.activity/activityExchangeContent
请求参数:
参数名 | 参数类型 | 是否必填 | 参数说明 | 示例值 |
---|---|---|---|---|
uid | string | 是 | 活动id |
- 成功示例:
{
"data": {
"content": "<p style=\"line-height: 2em;\">活动兑换规则说明</p>"
},
"code": 100,
"msg": "请求成功"
}
参数名 | 参数类型 | 是否必有 | 参数说明 | 示例值 |
---|---|---|---|---|
content | string | 是 | 活动兑换说明 |
- 失败示例:
{
"code": 101,
"data": [],
"msg": "请求失败"
}
规则说明
该接口用户获取活动的规则说明,由于是一个富文本格式的内容,减少对带宽的使用,因此单独提供一个接口使用。
请求方法:GET
是否鉴权:否
请求编码:Content-Type:application/x-www-form-urlencoded
响应编码:Content-Type:application/json;charset=UTF-8
请求地址:index/activity.activity/activityRuleContent
请求参数:
参数名 | 参数类型 | 是否必填 | 参数说明 | 示例值 |
---|---|---|---|---|
uid | string | 是 | 活动id |
- 成功示例:
{
"data": {
"content": "<p style=\"line-height: 2em;\">活动兑换规则说明</p>"
},
"code": 100,
"msg": "请求成功"
}
参数名 | 参数类型 | 是否必有 | 参数说明 | 示例值 |
---|---|---|---|---|
content | string | 是 | 活动兑换规则 |
- 失败示例:
{
"code": 101,
"data": [],
"msg": "请求失败"
}
全量信息
用户答题名称、答题状态、答题轮播图等基础信息。
请求方法:GET
是否鉴权:否
请求编码:Content-Type:application/x-www-form-urlencoded
响应编码:Content-Type:application/json;charset=UTF-8
请求地址:index/activity.activity/activityContent
请求参数:
参数名 | 参数类型 | 是否必填 | 参数说明 | 示例值 |
---|---|---|---|---|
uid | string | 是 | 活动id |
- 成功示例:
{
"data": {
"banner": [
"https://www.tutudati.com/1061.jpg",
],
"cover": "https://www.tutudati.com/1061.jpg",
"title": "国庆知识大挑战:庆祝祖国华诞,答题赢荣耀",
"start_time": "2024-09-16 00:00:00",
"end_time": "2024-11-16 00:00:00",
"is_state": 1,
"state_title": "该活动进行中",
"remark": "国庆知识挑战",
"content": "<p style=\"line-height: 2em;\">活动详细说明</p>",
"origin_type": 1,
"type": "答题积分活动",
"video_url": "",
"audio_url": "",
"collection_uid": "",
"prize_exchange": "<p style=\"line-height: 2em;\">活动奖品兑换规则</p>",
},
"code": 100,
"msg": "请求成功"
}
参数名 | 参数类型 | 是否必有 | 参数说明 | 示例值 |
---|---|---|---|---|
title | string | 是 | 活动名称 | |
cover | string | 是 | 活动封面图 | |
banner | array | 是 | 轮播图数组 | |
start_time | string | 是 | 活动开始时间 | |
end_time | string | 是 | 活动结束时间 | |
state_title | string | 是 | 活动状态提示 | |
is_state | int | 是 | 活动状态值 | 1未开始2进行中3已结束4已取消 |
remark | string | 是 | 活动备注 | |
content | string | 是 | 活动说明 | |
origin_type | int | 是 | 活动类型 | 1答题积分活动2用户拉新活动3积分抽奖活动 |
type | string | 是 | 活动类型名称 | 答题积分活动用户拉新活动积分抽奖活动 |
video_url | string | 是 | 活动视频 | |
audio_url | string | 是 | 活动音频 | |
collection_uid | string | 是 | 活动试卷id | 如果是答题积分活动,则返回试卷对一个的id,否则为空。 |
prize_exchange | string | 是 | 兑奖说明 |
- 失败示例:
{
"code": 101,
"data": [],
"msg": "请求失败"
}