判断用户状态是否进入私信等
编号 : 10
请求参数
| 参数名 | 参数类型 | 必传 | 缺省值 | 描述 |
|---|---|---|---|---|
| friend_id | int | Y | 好友id | |
| type | nit | N | 1为判断好友系统是否关闭 |
返回值
{
"status": 1,
"msg": "success",
"data": ‘ ’,
"sign": "7c0d17adbb61a3662c6ec42ff6d1b589"
}
消息中心头部信息(刘家发)
编号 : 10
请求参数
| 参数名 | 参数类型 | 必传 | 缺省值 | 描述 |
|---|
返回值
{
"status": 1,
"msg": "成功",
"data": {
"list": [
{
"type": 6,
"num": 0
},
{
"type": 1,
"num": 0
},
{
"type": 4,
"num": 0
},
{
"type": 999,
"num": 0
}
],
"verifyCount": 0
},
"sign": "5539bc9dad6b6c1e106ad9fee216fb9b"
}
备注
//类型 1:通知,4:官方 999:游戏动态 6:点赞+回复 verifyCount:好友个数
发送消息(刘家发)
编号 : 10
请求参数
| 参数名 | 参数类型 | 必传 | 缺省值 | 描述 |
|---|---|---|---|---|
| friend_id | int | Y | 好友id | |
| msg_type | int | Y | 1普通聊天,2房间邀请,3常用语,4快捷回复,5游戏分线,6发现页分享,7帖子分享,8礼物卡分享 | |
| msg | string | Y | 房间邀请拼接成字符串 | |
| huid | int | N | 房主id(房间邀请的时候传输) | |
| game_id | int | N | 游戏id(房间邀请或者游戏分享的时候传输) | |
| discover_id | int | N | 发行页id(发现页分享是传参) | |
| topic_id | int | N | 帖子id(帖子分享是传参) | |
| forum_id | int | N | 论坛id(帖子分享是传参) |
返回值
{
"status": 1,
"msg": "发送成功",
"data": {
"msg_id":'789',
"ctime":1681368488,
"msg":习**主席
},
"sign": "7c0d17adbb61a3662c6ec42ff6d1b589"
}
聊天窗口(刘家发)
编号 : 10
请求参数
| 参数名 | 参数类型 | 必传 | 缺省值 | 描述 |
|---|---|---|---|---|
| friend_id | int | Y | 用户id |
返回值
{
"status": 1,
"msg": "成功",
"data": {
"pendant_info": {
‘font_color’:‘’,
‘pendant_left_pic’:‘’,
‘pendant_right_pic’:‘’,
‘nickname_color’:‘’,
},
"common_status":1,
"friend_relation": 2,
"common_words": [
{
"id": "1",
"words": "我等的花儿都谢了"
},
{
"id": "2",
"words": "还不开始"
},
{
"id": "3",
"words": "快开始吧"
}
]
},
"sign": "2703fb5cdcaf9fb823b8fc8393e87697"
}
备注
friend_relation:1好友,2对方不是我好友,3拉黑对方,4被删除,5被拉黑,6对方已注销 common_words:常用语 common_status:1开启
通知服务端获取的撤回的消息(刘家发)
编号 : 10
请求参数
| 参数名 | 参数类型 | 必传 | 缺省值 | 描述 |
|---|---|---|---|---|
| msg_id | array | Y | 消息id数组 |
返回值
{
"status": 1,
"msg": "成功",
"data": ' ',
"sign": "95e35d3a85fd83055f651039b1b2646f"
}
获取撤回的消息(刘家发)
编号 : 10
请求参数
| 参数名 | 参数类型 | 必传 | 缺省值 | 描述 |
|---|
返回值
{
"status": 1,
"msg": "成功",
"data": {
"list": [
789,
456
]
},
"sign": "95e35d3a85fd83055f651039b1b2646f"
}
备注
list,消息id
校验消息是否收到(刘家发)
编号 : 10
请求参数
| 参数名 | 参数类型 | 必传 | 缺省值 | 描述 |
|---|---|---|---|---|
| send_id | string | Y | 消息id | |
| friend_id | int | Y | 好友id |
返回值
{
"status": 1,
"msg": "校验成功",
"data": " ",
"sign": "7c0d17adbb61a3662c6ec42ff6d1b589"
}
移除消息(刘家发)
编号 : 10
请求参数
| 参数名 | 参数类型 | 必传 | 缺省值 | 描述 |
|---|---|---|---|---|
| friend_id | int | Y | 好友id |
返回值
{
"status": 1,
"msg": "移除成功",
"data": " ",
"sign": "7c0d17adbb61a3662c6ec42ff6d1b589"
}
云存储-获取请求链接(#todo)
编号 : 10
请求参数
| 参数名 | 参数类型 | 必传 | 缺省值 | 描述 |
|---|---|---|---|---|
| key | string | Y | 文件名称 唯一性 |
返回值
{
"status": 1,
"msg": "请求成功",
"data": {
"status": 1,
"msg": "请求成功",
"data": {
"link": 1681120046,
}
}
}
云存储--获取相关秘钥信息
编号 : 10
请求参数
| 参数名 | 参数类型 | 必传 | 缺省值 | 描述 |
|---|---|---|---|---|
| file_name | string | Y | 文件名称 唯一性 |
返回值
{
"status": 1,
"msg": "请求成功",
"data": {
"status": 1,
"msg": "请求成功",
"data": {
"expiredTime": 1681120046,
"expiration": "2023-04-10T09:47:26Z",
"credentials": {
"sessionToken": "j3863J1ILSnILhZQCG5rVy1logKBsTCa12ced69f1cbbabb09fd5425a0bc455c8qt1iXTzGCuGkIaFIJ7mLal5Kdwk2LghoJWyIEIh6KLDLpKvM-79VOyIOc88qc77e1UOPUYq4kwD9ZjdrLBmMsOWmxsPnoRPJ6UtMK3OSUqbB08OAkTBG9jcjHcgr7pcWrBFnZclCjrnnxzFfnXR6eltAWW2sFbfvtwnlCBSDOu9b6xOOjU2YVip4g0ZFFPtYb0iMrKfvuCqbJ7Hskfep6Bdnh5FU3yNPSeAyKysZ4YuvvldWMI_LyQ4005p4ITbDVG7SFzFVLPELihSBH0WqnUDgoaH4PyRDHaqQxWFGoKfmerOSp1Nwr1Yut4QbUMHHl3_LjFQzq6C2NQ_-lXpXHXy_GYB6-vL4D0GMx8KHkiv1fxvxfWQDXP8QYeLikidr4s9GYVkfOKkUphNsQEPj8onR5HpI4VPRoQTs8BEBY7F417PXYw-2ChYo2hlIsg0jonpkeQLEKo_z7ByjYZCY5hBXPwjVOm-Wf_B4oIunL4v5S3j9J9DqfjRSsBx6b708ELCXqIeE1RBK0FLEtoPityctPlKKXv1tLkWEHCzh8yK8ZnU7NH4ybDLPAQ3qu9dbtIMuUP59HcQ-yZ1ZMYiljnVK0rcTL0K30QGEkXSDICzqYSSj80ZZuV4AJlXODdJI",
"tmpSecretId": "AKIDrt8ed_3DgoyjLYcjli-Onz3_4gWQislCpRiNz8Nyx3PQRCkhk-SvGzTTJzCf-94O",
"tmpSecretKey": "mHAKL/Ra6rqawWAa438F78YFBjNtGMQ32dqLc3wZnac="
},
"requestId": "0c78eae5-d3d2-4608-8f02-1ae5827792b2",
"startTime": 1681118246,
"region": "ap-beijing",
"bucket": "cloudgames-870-chat-1254075445",
}
}
}
置顶聊天(刘家发)
编号 : 10
请求参数
| 参数名 | 参数类型 | 必传 | 缺省值 | 描述 |
|---|---|---|---|---|
| friend_id | int | Y | 好友id | |
| status | int | Y | 1置顶,2取消置顶 |
返回值
{
"status": 1,
"msg": "置顶成功",
"data": {
"list": [
{
"uid": "6224",
"nickname": "新用户22319731",
"avatar": null,
"avatar_box": "0",
'last_time','1682474537'
}
],
'msg':'已成功置顶,你还可以置顶1个好友哦',
},
"sign": "7c0d17adbb61a3662c6ec42ff6d1b589"
}
备注
list:置顶的用户ud
消息中心(刘家发)
编号 : 10
请求参数
| 参数名 | 参数类型 | 必传 | 缺省值 | 描述 |
|---|---|---|---|---|
| page | int | Y | 0 | page从0开始 |
返回值
{
"status": 1,
"msg": "成功",
"data": {
"vip":0//1会员,0不是会员
"list": [
{
"type": 1,//类型 1:系统 2:点赞 3:回复 4:官方 999:预约 6:点赞+回复
"num": 0,
"num_string": "1"
},
{
"type": 2,
"num": 0
},
{
"type": 3,
"num": 0
},
{
"type": 4,
"num": 0
}
],
"verifyCount": 0,
"advertInfo":
{
"title": "测试4号",
"jump_type": 24,
"jump_url": "https://app.cgame.com/?r=web&m=vip&ac=index&code=xjl3JkZrIOp2MoDWQT7B7w%3D%3D",
"advert_type":1,//0非会员广告样式1 1会员广告样式2
},
"uids_info": [
{
"uid": "6224",
"nickname": "新用户22319731",
"avatar": null,
"avatar_box": "0",
"top" :2//1置顶,2无需置顶,
"last_time":1682040603(跟这个用户的最后聊天时间)
}
]
},
‘top_msg’:'长按置顶你的亲密好友,让Ta的消息更显耀~',
"sign": "2545978e9030e62d30026fef1227b49e"
}
备注
//类型 1:系统 2:点赞 3:回复 4:官方 999:预约 6:点赞+回复 verifyCount:好友个数 uids_info:列表信息 advertInfo:广告信息
获取离线消息(刘家发)
编号 : 10
请求参数
| 参数名 | 参数类型 | 必传 | 缺省值 | 描述 |
|---|
返回值
{
"status": 1,
"msg": "获取成功",
"data": {
'verifyCount':2,
"list": [
{
"pendant_info": {
"font_color": "",
"pendant_left_pic": "",
"pendant_right_pic": '',
"nickname_color": ""
},
"user_info": {
"uid": "315",
"nickname": "315",
"avatar": null,
"avatar_box": "0"
},
"msgArr": [
{
"msg_id": "6224-1680776710",
"msg": 999,
"ctime":1680853719,
"msg_type":1
},
{
"msg_id": "6224-1680776693",
"msg": 999,
"ctime":1680853715,
"msg_type":1
},
{
"msg_id": "6224-1680776645",
"msg": 999,
"ctime":1680853718,
"msg_type":1
}
]
]
},
"sign": "de90c503a59208d58a9e3af621d616f2"
}
备注
verifyCount:好友申请数量
设置消息通知设置(刘家发)
编号 : 10
请求参数
| 参数名 | 参数类型 | 必传 | 缺省值 | 描述 |
|---|---|---|---|---|
| type | int | Y | 1红点,2不在游戏中,3在游戏中 | |
| status | int | Y | 1开启,2关闭 |
返回值
{
"status": 1,
"msg": "设置成功",
"data": {
"remind_red": 1,
"remind_no_game": 1,
"remind_in_game": 1
},
"sign": "43d583db551b4d0fda3c5e15d365ff43"
}
备注
type:1红点,2不在游戏中,3在游戏中
获取消息通知设置(刘家发)
编号 : 10
请求参数
| 参数名 | 参数类型 | 必传 | 缺省值 | 描述 |
|---|
返回值
{
"status": 1,
"msg": "获取成功",
"data": {
"remind_red": 1,
"remind_no_game": 1,
"remind_in_game": 1
},
"sign": "a6b62cd837df88a9a06d21439743fcdd"
}
备注
remind_red:1://1开启2关闭 红点 remind_no_game:1://1开启2关闭 不在游戏中 remind_in_game:1://1开启2关闭 在游戏中
黑名单列表(刘家发)
编号 : 10
请求参数
| 参数名 | 参数类型 | 必传 | 缺省值 | 描述 |
|---|---|---|---|---|
| page | int | Y | 0 | page从0开始 |
返回值
{
"status": 1,
"msg": "成功",
"data": {
"msg":'黑名单用户无法添加我为好友,无法查看TA的信息流',
"list": [
{
"uid": 315,
"nickname": "315",
"avatar": "http://pic.buke999.com/group1/M00/00/61/wKgUiGGOA2yIGlCjAAAdX63yKW0AAAjOwHYfr0AAB13725.jpg",
"avatar_box":1
},
],
}
}
备注
msg:文案
联机房 拒绝 好友邀请
编号 : 10
请求参数
| 参数名 | 参数类型 | 必传 | 缺省值 | 描述 |
|---|---|---|---|---|
| huid | int | Y | 0 | 房主uid |
| gid | int | Y | 本站游戏id |
返回值
{
"status": 1,
"msg": "成功",
"data": {
"code": 1,
"send_msg":"现在不方便,下次再约",
"send_time":1
}
}
联机房 邀请 好友玩游戏
编号 : 10
请求参数
| 参数名 | 参数类型 | 必传 | 缺省值 | 描述 |
|---|---|---|---|---|
| huid | int | Y | 0 | 房主uid |
| gid | int | Y | 本站游戏id | |
| friend_uid | int | Y | 好友uid | |
| mode | string | Y | 房间模式 | |
| controller_num | int | Y | 已使用的控制权数量 | |
| online_num | int | Y | 房间在线人数 | |
| room_name | string | Y | 房间名称 |
返回值
{
"status": 1,
"msg": "成功",
"data": " "
}
{
"status": -100,
"msg": "已邀请好友,18s后可重新邀请",
"data": " "
}
联机房/文章、游戏 - 邀请/分享好友列表
编号 : 10
请求参数
| 参数名 | 参数类型 | 必传 | 缺省值 | 描述 |
|---|---|---|---|---|
| page | int | Y | 0 | 页码,从0开始 |
| pageSize | int | N | 20 | |
| huid | int | N | 0 | 房主uid |
| gid | int | N | 本站游戏id | |
| rid | int | N | 0 | 房间id |
| score | int | Y | 0 | 分页传参 |
返回值
#备注 code=1 时候正常请求list列表数据 code==100时候 保留现有客户端的列表数据 code=3 好友功能关闭
{
"status": 1,
"msg": "成功",
"data": {
"code": 1,
'tip':"存在延迟",
'score':0,
'controller_total_num':6,//控制权总数量
"list": [
{
"uid": 315,
"nickname": "315",
"avatar": "http://pic.buke999.com/group1/M00/00/61/wKgUiGGOA2yIGlCjAAAdX63yKW0AAAjOwHYfr0AAB13725.jpg",
"avatar_box": "1",
"vip_status":0,
"invite_status":0,
"online": 1,
}
]
}
}
{
"status": 1,
"msg": "成功",
"data": {
"code": 100,
"error": "请勿频繁操作",//这个错误 不提示
"list": []
}
}
备注
online:1在线 2不在线 avatar_box:头像框id "vip_status": "1"//1会员,0不是会员 invite_status : 0邀请 1已邀请60s 2已拒绝300s 3已加入
校验好友系统是否正常开启
编号 : 11
请求参数
| 参数名 | 参数类型 | 必传 | 缺省值 | 描述 |
|---|
返回值
{
"status": 1,
"msg": "成功",
"data": {
"code": 1
}
}
错误toast不变
{
"status": -100,
"msg": "好友系统关闭",
"data": " "
}
广告位(弃用)
编号 : 10
请求参数
| 参数名 | 参数类型 | 必传 | 缺省值 | 描述 |
|---|
返回值
{
"status": 1,
"msg": "成功",
"data": {
"title": "测试4号",
"jump_type": 24,
"jump_url": "https://app.cgame.com/?r=web&m=vip&ac=index&code=xjl3JkZrIOp2MoDWQT7B7w%3D%3D"
}
}
备注
jump_type:跳转类型,1:游戏详情,2:发现详情,3:专题,4:外部链接 10新专题 20论坛 21帖子 23 联机房间(房主id|游戏id) 24会员购买页面 jump_url:
设置好友申请设置状态(刘家发)
编号 : 10
请求参数
| 参数名 | 参数类型 | 必传 | 缺省值 | 描述 |
|---|---|---|---|---|
| type | int | Y | 2关闭。1开启 |
返回值
{
"status": 1,
"msg": "设置成功",
"data": " ",
"sign": "d41d8cd98f00b204e9800998ecf8427e"
}
获取好友申请设置状态(刘家发)
编号 : 10
请求参数
| 参数名 | 参数类型 | 必传 | 缺省值 | 描述 |
|---|
返回值
{
"status": 1,
"msg": "已同意",
"data": {
"allowFriend":1
},
"sign": "a5609a2fdf6fc1cad4b7ba2565e09b6e"
}
备注
allowFriend:2不允许别人加我为好友,1开启弹窗验证
拒绝或者同意好友申请(刘家发)
编号 : 10
请求参数
| 参数名 | 参数类型 | 必传 | 缺省值 | 描述 |
|---|---|---|---|---|
| status | int | Y | 1 | 2同意,3拒绝,4已过期 |
| friend_id | int | Y | 好友id |
返回值
{
"status": 1,
"msg": "已同意",
"data": {
'status_apply':2
},
"sign": "a5609a2fdf6fc1cad4b7ba2565e09b6e"
}
备注
status_apply:4已过期,3已拒绝,2已同意
好友列表(刘家发)
编号 : 9
请求参数
| 参数名 | 参数类型 | 必传 | 缺省值 | 描述 |
|---|---|---|---|---|
| page | int | Y | 页码,从0开始 | |
| ctime | int | Y | 最后一个元素的时间戳 |
返回值
{
"status": 1,
"msg": "获取成功",
"data": {
"verifyCount": 0,
"reminder": "好友状态更新可能存在延迟,状态仅供参考哦",
"list": [
{
"uid": "6224",
"nickname": "新用户22319731",
"avatar": null,
"sign": null,
"avatar_box": "0",
"vip_status": 0,
"friend_status": 1,
"is_remove": 1,
"remove_text": ‘对方已屏蔽你的互动’,
"online": 2,
"eternal_star": 1
},
{
"uid": "67",
"nickname": "云端嘴强王者内呸内呸呸对对对",
"avatar": "group1/M00/00/1E/wKg-1F7oYiaATKAGAAGXosKvs08037.png",
"sign": "口语我摸摸摸摸",
"avatar_box": "0",
"vip_status": 0,
"friend_status": 1,
"is_remove": 2,
"remove_text": ‘’,
"online": 2,
"eternal_star": 1
}
],
"ctime": 1681177067
},
"sign": "2bb22a59f11ac6388fcdd2ac4abc96c4"
}
备注
reminder:文案提醒
friend_status:1好友,2拉黑/删除,4用户注销
is_remove:1移除,2无需移除
remove_text:根据is_remove来判断,is_remove为1的需要展示
avatar_box:头像框id
‘online’:1,//1在线,2不在线
verifyCount:好友申请数量
"vip_status": "1"//1会员,0不是会员
"game_name": "洪荒打劫"//游戏名称,
"gid": "1"//游戏id,
"huid": "315"/房主id,
"is_owner": "1"//是否房主,1是,0不是
获取好友申请列表(刘家发)
编号 : 6
请求参数
| 参数名 | 参数类型 | 必传 | 缺省值 | 描述 |
|---|---|---|---|---|
| page | int | Y | 0 | page从0开始 |
| ctime | int | Y | 时间戳 |
返回值
{
"status": 1,
"msg": "获取成功",
"data": {
"list": [
{
"friend_id": "6224",
"nickname": "新用户22319731",
"avatar": null,
"sign": 个性签名,
"vip_status": 0,
"msg": "ddddd",
"status": "3",
"ctime": "1681179922"
},
{
"friend_id": "315",
"nickname": "315",
"avatar": null,
"sign": 个性签名,
"vip_status": 0,
"msg": "啦啦啦啦",
"status": "2",
"ctime": "1681177066"
}
],
"msg": "请尽快处理好友申请消息,长时间未处理的消息会过期哦~",
"ctime": 1681192408
},
"sign": "41c97e1ab326f67b20d5bc6aa4ad8620"
}
备注
"status": 1//1申请,2已同意,3已拒绝,4已过期, msg:验证消息
最近一起玩 【添加】游戏好友
编号 : 4
请求参数
| 参数名 | 参数类型 | 必传 | 缺省值 | 描述 |
|---|---|---|---|---|
| gid | int | Y | 1 | 本站游戏id 【备注:合集游戏传 主游戏id】 |
返回值
{
"status": 1,
"msg": "成功",
"data": {
"code": 1
}
}
最近一起玩游戏好友【列表】
编号 : 3
请求参数
| 参数名 | 参数类型 | 必传 | 缺省值 | 描述 |
|---|---|---|---|---|
| score | int | N | 0 | 默认0 返参带有这个参数 |
| pageSize | int | N | 20 | 默认 |
| page | int | N | 0 | 页码 |
| site | int | N | 0 | 0默认 1添加好友搜索页面的最近一起玩用户 |
返回值
{
"status": 1,
"msg": "成功",
"data": {
"tip": "此列表最近一起玩过的玩家可能会延迟几分钟显示哦",
"list": [
{
"gid": 90,//【游戏id】
"utime": "15:41",//【时间】
"self_uid": 1,
"uid": 112,//【游戏好友id】
"avatar": "http://pic.buke999.com/group1/M00/00/61/wKgUiGGOA2yIGlCjAAAdX63yKW0AAAjOwHYfr0AAB13725.jpg",//【头像】
"nickname": "66251177",//【昵称】
"avatar_box": "", //【头像框】
"vip_state": 0, //【1 有vip标识】
"friend_status": 1, //【1好友(私信-按钮), 6对方已注销(没有按钮) 2对方不在我的好友名单中,5被拉黑,4被删除,3拉黑对方】
"take_off": 1,//【1游戏已下架】
"game_name": "洛克王国IE" //【游戏名称】
"eternal_star": -1
},
],
"total":20,//【总条数】
"score": 7,
"nobody_info": { //备注 list 好友为空时候,调用这个
"open_play": 1,
"content": "最近和谁组队过",
"jump_title": "跳转链接",
"jump_type": 1,
"jump_content": "1"
}
}
}
备注
tip: 好友列表头部的一个说明文案
list:好友列表 【备注:好友为空时,这个list key还是存在,数据为空】
utime : 最近玩时间
vip_state 1 有vip标识
status: 1用户已注销(没有按钮) 2好友(私信--按钮) 3非好友(加好友 --按钮)
friend_status 1好友(私信-按钮), 6对方已注销(没有按钮) 2对方不在我的好友名单中,5被拉黑,4被删除,3拉黑对方
nobody_info: 好友为空 且 后台开启, 会有这个key以及内容
jump_type: 1游戏详情 2发现详情 3专题 4外部链接 10新专题 20论坛 21帖子 23联机房间【房主id|游戏id】
最近一起玩【删除】游戏好友
编号 : 2
请求参数
| 参数名 | 参数类型 | 必传 | 缺省值 | 描述 |
|---|---|---|---|---|
| friends | array | N | 0 | [1,3,4,5] 好友 数组格式 全选可不用传游戏好友 |
| is_all | int | Y | 0 | 0默认批量选中 1全选 |
返回值
{
"status": 1,
"msg": "成功",
"data": {
"code": 1
}
}
发送好友申请(刘家发)
编号 : 1
请求参数
| 参数名 | 参数类型 | 必传 | 缺省值 | 描述 |
|---|---|---|---|---|
| friend_id | int | Y | 0 | 列要添加为好友的id表带返参 |
| msg | string | Y | 验证消息 |
返回值
{
"status": 1,
"msg": "ta的APP版本不支持好友功能,请先提醒ta升级至1.7.0及以上版本哦~",
"data":{
"msg":'ta的APP版本不支持好友功能,请先提醒ta升级至1.7.0及以上版本哦~'
},
"sign": "d41d8cd98f00b204e9800998ecf8427e"
}
备注
vip_state 1 有vip标识
status: 1用户已注销(没有按钮) 2好友(私信--按钮) 3非好友(加好友 --按钮)