文章目录
1. 发送富文本公告(分批)
1.1 说明
- 运用于 GM系统-操作工具-公告管理-添加&修改富文本公告
- 该接口是分批请求接口,当渠道或游戏服数量大于1000,会以每批1000条进行发送
- 有渠道或游戏服追加时,会增量请求
- 注:在添加&修改富文本公告时就会调用此接口,公告的显示需要由接入方自行处理
1.2 请求方式
- POST
- Content-Type:application/x-www-form-urlencoded
1.3 请求参数
参数名 | 类型 | 长度 | 说明 | 是否必传 |
---|---|---|---|---|
anc_id | string | 11 | 公告ID,唯一 | 是 |
anc_type | int | 1 | 公告类型,固定为1,表示富文本 | 是 |
title | string | 50 | 公告标题 | 是 |
list_title | string | 50 | 公告列表标题,可选 | 否 |
content | string,json格式 | - | 公告内容,富文本json,参见“请求参数说明”关于富文本的说明 | 是 |
channel_id_list | string,json格式 | - | 多个渠道id,和游戏服id二选一 | 否 |
sid_list | string,json格式 | - | 多个游戏服id,和渠道id二选一 | 否 |
start_time | string | - | 开始生效时间,格式YYYY-MM-DD hh:mm:ss | 是 |
end_time | string | - | 生效结束时间,格式YYYY-MM-DD hh:mm:ss | 是 |
create_time | string | - | 创建时间,格式YYYY-MM-DD hh:mm:ss | 是 |
update_time | string | - | 更新时间,格式YYYY-MM-DD hh:mm:ss | 是 |
sort | int | 11 | 优先级,0置顶、-1置底,>0值越大越优先 | 是 |
tag | string | 32 | 标签,可选 | 否 |
img_list | string,json格式 | - | 轮播图,可选 | 否 |
is_del | int | 1 | 默认0,1表示这一批次的数据都要删除 | 是 |
channel_id_list参数示例:
["11","22"]
sid_list参数示例:
["aa","bb"]
img_list参数说明:
参数名 | 类型 | 长度 | 说明 | 是否必传 |
---|---|---|---|---|
img | string | - | 图片url | 是 |
link | string | - | 图片跳转链接,选填 | 否 |
img_list参数示例:
[
{
"img": "http://img1",
"link": "link1"
},
{
"img": "http://img2",
"link": "link2"
}
]
1.4 返回参数
- 响应示例:
{
"status":1,
"msg":"success",
"data":{
}
}
2. 发送跑马灯公告(分批)
2.1 说明
- 运用于 GM系统-操作工具-公告管理-添加&修改跑马灯公告
- 该接口是分批请求接口,当渠道或游戏服数量大于1000,会以每批1000条进行发送
- 注:在添加&修改跑马灯公告时就会调用此接口,公告的显示需要由接入方自行处理
2.2 请求方式
- POST
- Content-Type:application/x-www-form-urlencoded
2.3 请求参数
参数名 | 类型 | 长度 | 说明 | 是否必传 |
---|---|---|---|---|
anc_id | string | 11 | 公告ID,唯一 | 是 |
anc_type | int | 1 | 公告类型,固定为2,表示跑马灯 | 是 |
content | string | - | 公告内容,纯文本 | 是 |
channel_id_list | string,json格式 | - | 多个渠道id,和游戏服id二选一 | 否 |
sid_list | string,json格式 | - | 多个游戏服id,和渠道id二选一 | 否 |
start_time | string | - | 开始生效时间,格式YYYY-MM-DD hh:mm:ss | 是 |
end_time | string | - | 生效结束时间,格式YYYY-MM-DD hh:mm:ss | 是 |
create_time | string | - | 创建时间,格式YYYY-MM-DD hh:mm:ss | 是 |
update_time | string | - | 更新时间,格式YYYY-MM-DD hh:mm:ss | 是 |
sort | int | 11 | 优先级,0置顶、-1置底,>0值越大越优先 | 是 |
interval | int | 11 | 播放间隔,分钟 | 是 |
is_del | int | 1 | 默认0,1表示这一批次的数据都要删除 | 是 |
channel_id_list参数示例:
["11","22"]
sid_list参数示例:
["aa","bb"]
2.4 返回参数
- 响应示例:
{
"status":1,
"msg":"success",
"data":{
}
}
3. 删除公告
3.1 说明
- 运用于 GM系统-操作工具-公告管理-删除富文本公告&跑马灯公告
- 注:在删除富文本公告&跑马灯公告时就会调用此接口,公告的显示需要由接入方自行处理
3.2 请求方式
- POST
- Content-Type:application/x-www-form-urlencoded
3.3 请求参数
参数名 | 类型 | 长度 | 说明 | 是否必传 |
---|---|---|---|---|
anc_id | string | 11 | 公告ID,唯一 | 是 |
anc_type | int | 1 | 公告类型,1富文本 2跑马灯 | 是 |
3.4 返回参数
- 响应示例:
{
"status":1,
"msg":"success",
"data":{
}
}