管理应用
优质
小牛编辑
139浏览
2023-12-01
管理应用
查询应用可见范围
请求方式:POST(HTTPS)
请求地址:https://qy.im.baidu.com/api/agent/getAllow?access_token=ACCESS_TOKEN
请求body:
{
"agentid": 22
}
参数说明:
参数 | 类型 | 参数位置 | 是否必须 | 说明 |
---|---|---|---|---|
agentid | String | RequestBody | 是 | 应用ID,可在应用的设置页面查看 |
权限要求: 管理组须拥有指定应用的使用权限。
返回结果:
{
"errcode": 0,
"errmsg": "ok",
"userids": ["userid1"],
"departmentids": [2],
"tagids": [3]
}
参数说明:
参数 | 说明 |
---|---|
errcode | 成功 |
errmsg | ok:成功 |
userids | 成员列表 |
departmentids | 部门列表 |
tagids | 标签列表 |
应用消息红点
请求方式:POST(HTTPS)
请求地址:https://qy.im.baidu.com/api/appcenter/notify?access_token=ACCESS_TOKEN
请求body:
{
"touser": "UserID1|UserID2|UserID3",
"agentid": "1"
}
参数说明:
参数 | 类型 | 参数位置 | 是否必须 | 说明 |
---|---|---|---|---|
access_token | String | Url参数 | 是 | 调用接口凭证,参考 获取access_token |
touser | String | RequestBody | 是 | 成员列表,以竖线分隔 |
agentid | String | RequestBody | 是 | 应用ID,可在应用的设置页面查看 |
权限要求: 管理组须拥有指定应用的使用权限,被提醒的接受者必须处于应用的可见范围内并已经关注应用。
返回结果: 如果无权限,则本次发送失败;如果收件人不存在或未关注,发送仍然执行,但返回无效的部分。
{
"errcode": 0,
"errmsg": "ok",
"invaliduser": "UserID1"
}
参数说明:
参数 | 说明 |
---|---|
errcode | 成功 |
errmsg | ok:成功 |
invaliduser | 无效成员列表,以竖线分隔 |
批量查询用户是否关注该应用
请求方式:POST(HTTPS)
请求地址:https://qy.im.baidu.com/api/agent/isFollow?access_token=ACCESS_TOKEN
请求body:
{
"agentid": 22,
"userids": ["userId1", "userId2"]
}
参数说明:
参数 | 类型 | 参数位置 | 是否必须 | 说明 |
---|---|---|---|---|
access_token | String | Url参数 | 是 | 调用接口凭证,参考 获取access_token |
agentid | Integer | RequestBody | 是 | 应用ID,可在应用的设置页面查看 |
userids | List | RequestBody | 是 | 成员列表,最多100个 |
权限要求: 管理组须拥有指定应用的使用权限。
返回结果: 如果无权限,则本次发送失败;如果收件人不存在或未关注,发送仍然执行,但返回无效的部分。
{
"errcode": 0,
"errmsg": "ok",
"userlist": [
{
"userid": "zhangsan",
"followTime": "2016-06-27 17:33:47",
"isFollow": true
}
]
}
参数说明:
参数 | 说明 |
---|---|
errcode | 成功 |
errmsg | ok:成功 |
userlist | 成员列表 |
userid | 成员UserID |
followTime | 关注日期 |
isFollow | true:已关注,false:未关注 |