查看群组
接口地址
[接口服务器地址]/api/groups/get.html
请求方法
POST
Request Headers
名称 | 必选 | 类型 | 说明 |
---|---|---|---|
Content-Type | true | string | application/json; charset=UTF-8 |
authen | true | string | 认证码 什么是认证码 |
appid | true | string | 接入ID 什么是接入ID |
timestamp | true | string | 时间戳 |
uid | true | string | 当前帐号 |
lang | true | string | 语言 zh-cn,en-us |
Request Body
名称 | 必选 | 类型 | 说明 |
---|---|---|---|
group_id | true | string | 群组ID |
scope | true | string | 获取的信息范围 ["notice_list","msg_list","total_online"],notice_list 群组公告 msg_list 最近消息 total_online 在线统计(消耗性能) |
group_ver | false | string | 群组基本信息版本号 为空时返回最新群组基本信息 |
user_ver | false | string | 群组成员版本号 为空时返回最新群组成员信息 |
注意事项
total_online=1,会多出属性 total_online:{online_co6167a56e0fe811ed9fbf7c8ae1c76d87unt:100,offline_count:5}
调用样例及调试工具
测试接口返回结果(成功)
{"status":1,"code":0,"msg":"","data":{"gid":"e5f0ebbe514211e9baa488d7f697be9a","name":"测试群","type":0,"description":"","avatar":"","py_first":"csq","user_limit":1000,"user_count":2,"blocks_count":0,"is_public":1,"is_request":1,"invite_type":1,"is_need_confirm":0,"status":1,"owner":"user_id2","create_time":1514736000,"update_time":0,"user_ver":"1514736000","group_ver":"1514736000","is_mute":0,"members":[{"gid":"user_id1","account":"test1","name":"用户1","nickname":"测试","py_first":"cs","avatar":"","role":0},{"gid":"user_id2","account":"test2","name":"用户2","nickname":"","avatar":"","py_first":"","role":2}]}}