企业可通过此接口,获取会话内容存档本企业的内部群信息,包括群名称、群主id、公告、群创建时间以及所有群成员的id与加入时间。
请求方式:POST(HTTPS)
请求地址:https://qyapi.weixin.qq.com/cgi-bin/msgaudit/groupchat/get?access_token=ACCESS_TOKEN
请求示例:
{
"roomid":"wrNplhCgAAIVZohLe57zKnvIV7xBKrig"
}
参数说明:
参数 | 必须 | 说明 |
---|---|---|
access_token | 是 | 调用接口凭证 |
roomid | 是 | 待查询的群id |
此接口可以查询roomid对应的群信息,roomid可以从会话内容存档中获取到的roomid填充。只支持内部群。
权限说明:
企业需要使用会话内容存档应用secret所获取的accesstoken来调用(accesstoken如何获取?);
返回结果
{
"roomname": "蓦然回首",
"creator": "ZhangWenChao",
"room_create_time": 1592361604,
"notice": "",
"members": [
{
"memberid": "ZhangWenChao",
"jointime": 1592361605
},
{
"memberid": "xujinsheng",
"jointime": 1592377076
}
],
"errcode": 0,
"errmsg": "ok"
}
返回字段说明:
字段名 | 说明 |
---|---|
errcode | 返回码 |
errmsg | 对返回码的文本描述内容 |
roomname | roomid对应的群名称 |
creator | roomid对应的群创建者,userid |
room_create_time | roomid对应的群创建时间 |
notice | roomid对应的群公告 |
members | roomid对应的群成员列表 |
memberid | roomid群成员的id,userid |
jointime | roomid群成员的入群时间 |
错误说明:
返回码 | 说明 |
---|---|
301052 | 会话存档已过期 |