登录
基础
连接微信
办公
第三方应用开发 服务端API 应用授权 接口调用 获取应用权限详情
获取应用权限详情
最后更新：2023/12/04
该API用于获取代开发应用或第三方应用用户授权的权限详情。
请求方式：POST（HTTPS）
请求地址： https://qyapi.weixin.qq.com/cgi-bin/agent/get_permissions?access_token=ACCESS_TOKEN
参数说明：
| 参数 | 是否必须 | 说明 |
|---|---|---|
| access_token | 是 | 代开发自建应用access_token，获取方法参见获取access_token 第三方应用access_token，获取方法参见获取企业凭证 |
权限说明：
支持所有的代开发应用和第三方应用调用
返回结果：
{
"errcode":0 ,
"errmsg":"ok",
"app_permissions":["xxx::xxx::xx"]
}参数说明：
| 参数 | 说明 |
|---|---|
| errcode | 错误码 |
| errmsg | 错误描述 |
| app_permissions | 需要添加的权限列表，应用权限为字符串类型，应用权限对应的字符串描述参考附录。 |
附录
应用权限说明：
通讯录权限
| 权限分类 | 权限名称 | 权限描述 | 说明 |
|---|---|---|---|
| 通讯录权限 | contact:base:base | 通讯录基本信息只读 | 仅第三方应用返回 |
| 通讯录权限 | contact:base:single_user | 通讯录单个信息只读 | 仅第三方应用返回 |
| 通讯录权限 | contact:edit:all | 通讯录全部信息读写 | 仅第三方应用返回 |
| 可见范围内的成员敏感信息 | contact:sensitive:avatar | 头像 | - |
| 可见范围内的成员敏感信息 | contact:sensitive:qrcode | 二维码 | - |
| 可见范围内的成员敏感信息 | contact:sensitive:gender | 性别 | - |
| 可见范围内的成员敏感信息 | contact:sensitive:user_name | 姓名 | 仅代开发应用返回 |
| 可见范围内的成员敏感信息 | contact:sensitive:mobile | 手机号 | 仅代开发应用返回 |
| 可见范围内的成员敏感信息 | contact:sensitive:department_name | 部门名 | 仅代开发应用返回 |
| 可见范围内的成员敏感信息 | contact:sensitive:email | 邮箱 | 仅代开发应用返回 |
| 可见范围内的成员敏感信息 | contact:sensitive:position | 职务 | 仅代开发应用返回 |
| 可见范围内的成员敏感信息 | contact:sensitive:telephone | 座机 | 仅代开发应用返回 |
| 可见范围内的成员敏感信息 | contact:sensitive:address | 地址 | 仅代开发应用返回 |
| 可见范围内的成员敏感信息 | contact:sensitive:extattr | 拓展属性 | 仅代开发应用返回 |
| 可见范围内的成员敏感信息 | contact:sensitive:external_profile | 对外属性 | 仅代开发应用返回 |
| 可见范围内的成员敏感信息 | contact:sensitive:external_position | 对外职务 | 仅代开发应用返回 |
| 可见范围内的成员敏感信息 | contact:sensitive:biz_mail | 企业邮箱 | 仅代开发应用返回 |
组织架构权限
| 权限分类 | 权限名称 | 权限描述 | 说明 |
|---|---|---|---|
| 组织架构信息 | corp_arch:base:base | 应用可获取企业的部门组织架构信息 | |
| 组织架构信息 | corp_arch:member:direct_leader | 应用可获取企业可见范围内成员的直属上级 |
企业客户权限
| 权限分类 | 权限名称 | 权限描述 | 说明 |
|---|---|---|---|
| 可见范围内成员添加客户的基础信息 | externalcontact:base:base | 客户和客户群列表、昵称、备注、标签 | - |
| 可见范围内成员添加客户的敏感信息 | externalcontact:sensitive:mobile | 手机号 | - |
| 可见范围内成员添加客户的敏感信息 | externalcontact:sensitive:avatar | 头像 | - |
| 客户联系 | externalcontact:contact:tag | 管理企业客户标签 | - |
| 客户联系 | externalcontact:contact:group_msg | 群发消息给客户和客户群 | - |
| 客户联系 | externalcontact:contact:welcome_msg | 给客户发送欢迎语 | - |
| 客户联系 | externalcontact:contact:qrcode | 配置「联系我」二维码 | - |
| 客户联系 | externalcontact:contact:transfer | 在职继承 | - |
| 客户联系 | externalcontact:contact:resigned | 离职继承 | - |
| 客户联系 | externalcontact:contact:stat | 获取成员联系客户的数据统计 | - |
| 客户联系 | externalcontact:contact:product_album | 管理商品图册 | - |
| 客户联系 | externalcontact:contact:intercept_rule | 管理敏感词 | - |
| 客户群 | externalcontact:groupchat:welcome_msg | 配置入群欢迎语素材 | - |
| 客户群 | externalcontact:groupchat:stat | 获取客户群的数据统计 | - |
| 客户群 | externalcontact:groupchat:resigned | 分配离职成员的客户群 | - |
| 客户群 | externalcontact:groupchat:transfer | 分配在职成员的客户群 | - |
| 客户朋友圈 | externalcontact:moment:list | 获取企业全部的发表记录 | - |
| 客户朋友圈 | externalcontact:moment:post | 发表到成员客户的朋友圈 | - |
| 获客助手 | externalcontact:customer_acquisition:base | 查询获客数、管理获客链接、获取客户列表 | - |
| 居民联系 | externalcontact:resident:manage | 管理网格和事件 | 仅针对一级行业类型为政府的企业用户,仅代开发应用返回 |
微信客服
| 权限分类 | 权限名称 | 权限描述 | 说明 |
|---|---|---|---|
| 获取基础信息 | customerservice:base:base | 获取基础信息 | - |
| 管理账号、分配会话和收发消息 | customerservice:chat:manage | 管理客服账号、管理接待人员、分配客服会话、接收客服消息和相关事件、发送消息 | - |
| 服务工具 | customerservice:tool:upgrade | 配置「升级服务」 | - |
| 服务工具 | customerservice:tool:stat | 获取客服数据统计 | - |
对外收款
| 权限分类 | 权限名称 | 权限描述 | 说明 |
|---|---|---|---|
| 对外收款 | externalpay:base:base | 应用可以获取可见范围内成员的收款记录 | - |
办公
| 权限分类 | 权限名称 | 权限描述 | 说明 |
|---|---|---|---|
| 日程 | calendar:base:base | 应用可以为可见范围内成员创建日程、获取相关数据 | - |
| 会议 | meeting:base:base | 应用可以为可见范围内成员发起会议、获取相关数据 | - |
| 直播 | living:base:base | 应用可以为可见范围内成员创建直播、获取相关数据 | - |
| 邮件 | email:base:base | 应用可以向可见范围内成员发送邮件、获取相关数据 | - |
| 文档 | doc:base:base | 应用可以为可见范围内成员创建文档、获取相关数据 | - |
| 微盘 | wedrive:base:base | 应用可以为可见范围内成员创建空间和上传文件，获取微盘版本和容量信息 | - |
| 审批 | approval:base:base | 应用可以为可见范围内成员创建审批申请、获取相关数据 | - |
打卡
| 权限分类 | 权限名称 | 权限描述 | 说明 |
|---|---|---|---|
| 可获取应用可见范围内成员的打卡应用数据 | checkin:app:base | 打卡 | - |
智慧硬件
| 权限分类 | 权限名称 | 权限描述 | 说明 |
|---|---|---|---|
| 获取硬件设备基础数据 | hardware:base:base | 设备SN编码、设备名称、设备备注名称 | - |
| 考勤门禁设备 | hardware:checkin:checkin_data | 考勤打卡原始数据 | - |
| 考勤门禁设备 | hardware:checkin:temperature_data | 温度检测原始数据 | - |
| 考勤门禁设备 | hardware:checkin:accesscontrol_data | 门禁通行原始数据 | - |
| 考勤门禁设备 | hardware:checkin:read_rule | 读取门禁规则 | - |
| 考勤门禁设备 | hardware:checkin:edit_rule | 创建门禁规则 | - |
| 打印扫描设备 | hardware:printer:print | 发起文件打印 | - |
家校沟通
| 权限分类 | 权限名称 | 权限描述 | 说明 |
|---|---|---|---|
| 家校沟通 | school:base:base | 可读取家校通讯录，获取家长基本信息 | 仅支持具有家校通讯录的学校 |
| 家校沟通 | school:edit:all | 「家校沟通」使用和编辑权限，包括编辑家校通讯录和给家长发通知 | 仅支持具有家校通讯录的学校 |
| 家校沟通 | school:sensitive:mobile | 家长手机号 | 仅支持具有家校通讯录的学校，仅代开发应用返回 |
紧急应用通知
| 权限分类 | 权限名称 | 权限描述 | 说明 |
|---|---|---|---|
| 紧急应用通知 | emergency:base:push | 可通过语音电话提醒应用可见范围内成员查看应用推送的重要消息 | 仅医疗行业企业，仅代开发应用返回 |
政民沟通
| 权限分类 | 权限名称 | 权限描述 | 说明 |
|---|---|---|---|
| 巡查上报 | patrol:report:base | 可获取可见范围内成员巡查上报数据 | 仅政务行业企业，仅代开发应用返回 |
| 居民上报 | resident:report:base | 可获取可见范围内成员居民上报数据 | 仅政务行业企业，仅代开发应用返回 |
- 获取应用权限详情
本节内容
