服务端接口权限申请
概述
为避免保证数据安全,WeLink的接口被调用时,会校验access_token对应的应用是否已经申请了该接口的调用权限。如果没有申请该接口的调用权限时,将返回501错误,并提示“第三方接口无权限”。需要注意的是,如果新申请了权限,access_token需要重新获取。
应用在 开发者后台->应用开发-企业内部应用-We码或轻应用-“版本管理”标签的“接口权限”中申请权限。


服务端接口权限与API对应清单
| 模块 | 权限名称 | 权限描述 | 接口名 | 接口地址 |
|---|---|---|---|---|
| 轻应用鉴权 | 轻应用鉴权 | 轻应用鉴权,用于调用JS-API | 获取jsapi_ticket | /auth/v1/jstickets |
| 通讯录 | 租户详细信息 | 获取租户详细信息,如租户名称、许可、规模等 | 获取企业信息 | /tenant/v1/tenants |
| 用户登录信息 | 获取用户的基本信息,用于登录系统和应用 | 通过免登授权码查询用户userId | /auth/v2/userid | |
| 查询用户userId | /contact/v1/users/accounts | |||
| 判断用户是否为应用管理员 | /weopen/v1/isadmin | |||
| 用户详细信息 | 按userid或部门id获取用户更多详细信息,如工号、手机号、邮箱等详细 | 查询用户详情 | /contact/v1/users | |
| 查询用户详情(新) | /contact/v3/users | |||
| 查询部门的人员信息列表(详细信息) | /contact/v1/user/users | |||
| 查询用户详情 | /contact/v2/user/detail | |||
| 查询用户详情 | /contact/v1/user/detail | |||
| 查询部门用户 | /contact/v1/user/simplelist | |||
| 查询部门用户详情 | /contact/v2/user/list | |||
| 获取角色组列表 | /contact/v1/rolegroup/simplelist | |||
| 查询部门用户详情 | /contact/v1/user/list | |||
| 用户邮箱信息 | 获取用户信息,包括邮箱等敏感信息 | 获取用户邮箱信息 | /contact/v1/users/email | |
| 用户简单信息 | 按部门id获取用户简单信息,如userid、工号、中文名、英文名 | 查询部门的人员信息列表(简单信息) | /contact/v2/user/userid | |
| 通讯录同步 | 企业向WeLink同步通讯录信息 | 修改用户手机号 | /contact/v1/user/mobilenumber | |
| 异步批量同步用户 | /contact/v1/users/bulk | |||
| 异步批量同步用户(新) | /contact/v2/users/bulk | |||
| 异步批量更新用户 | /contact/v1/users/update | |||
| 查询人员信息同步结果 | /contact/v1/users/status | |||
| 异步批量同步部门 | /contact/v2/departments/bulk | |||
| 查询部门异步同步结果 | /contact/v2/departments/status | |||
| 创建角色组 | /contact/v1/rolegroup/create | |||
| 更新角色组 | /contact/v1/rolegroup/update | |||
| 删除角色组 | /contact/v1/rolegroup/delete | |||
| 创建角色 | /contact/v1/role/create | |||
| 更新角色 | /contact/v1/role/update | |||
| 删除角色 | /contact/v1/role/delete | |||
| 创建用户 | /contact/v1/user/create | |||
| 更新用户 | /contact/v1/user/update | |||
| 删除用户 | /contact/v1/user/delete | |||
| 创建部门 | /contact/v1/department/create | |||
| 更新部门 | /contact/v1/department/update | |||
| 删除部门 | /contact/v1/department/delete | |||
| 批量创建用户 | /contact/v1/user/batch/create | |||
| 批量同步用户 | /contact/v1/user/batch/sync | |||
| 批量更新用户 | /contact/v1/user/batch/update | |||
| 批量更新绑定手机号码 | /contact/v1/user/batch/updatemobile | |||
| 批量更新客户侧用户corpUserId | /contact/v1/user/batch/updatecorpuid | |||
| 批量删除用户 | /contact/v1/user/batch/delete | |||
| 批量创建部门 | /contact/v2/department/batch/create | |||
| 批量创建部门 | /contact/v1/department/batch/create | |||
| 批量更新部门 | /contact/v2/department/batch/update | |||
| 批量更新部门 | /contact/v1/department/batch/update | |||
| 批量更新客户侧部门corpDeptCode | /contact/v1/department/batch/updatecorpdept | |||
| 批量删除部门 | /contact/v1/department/batch/delete | |||
| 获取异步任务结果 | /contact/v1/batch/result | |||
| 组织架构信息 | 按userid或部门id,以部门编码方式获取组织架构 | 查询部门详情 | /contact/v1/departments/{deptcode} | |
| 查询父部门信息 | /contact/v1/department/parent | |||
| 查询子部门信息 | /contact/v3/departments/list | |||
| 查询用户父级部门 | /contact/v1/user/parent | |||
| 获取角色组详情 | /contact/v1/rolegroup/detail | |||
| 获取角色组列表 | /contact/v1/rolegroup/list | |||
| 获取角色详情 | /contact/v1/role/detail | |||
| 查询指定角色用户列表 | /contact/v1/role/simplelist | |||
| 查询部门详情 | /contact/v2/department/detail | |||
| 查询部门详情 | /contact/v1/department/detail | |||
| 查询部门列表 | /contact/v2/department/list | |||
| 查询部门列表 | /contact/v1/department/list | |||
| 查询父部门列表 | /contact/v2/department/parent | |||
| 用户权限信息 | 获取用户权限信息,包括分域管理员所管理的部门范围等 | 获取分域管理员管理的部门范围 | /admincenter/v1/user/domain/scope | |
| 群消息服务 | 发送消息 | 以系统名义向指定固定群或讨论组发送消息。 | 发消息到群组 | /welinkim/v1/im-service/chat/group-chat |
| 群组管理 | 包括群组创建、名称修改、添加/移除成员、解散群组等群组管理操作。 | 创建群组 | /welinkim/v1/group-service/group/create-group | |
| 解散群组 | /welinkim/v1/group-service/group/disband-group | |||
| 转让群组身份 | /welinkim/v1/group-service/group/transfer-group-owner | |||
| 加用户到群组 | /welinkim/v1/group-service/group-member/add-group-member | |||
| 将用户移出群组 | /welinkim/v1/group-service/group-member/remove-group-member | |||
| 修改群组名称 | /welinkim/v1/group-service/group/modify-group-name | |||
| 修改群组容量 | /welinkim/v1/group-service/group/modify-group-capacity | |||
| 消息通知 | 公众号消息 | 通过公众号推送通知消息 | 公众号消息接口 | /messages/v3/send |
| 普通卡片消息 | /messages/v1/card/common | |||
| 应用卡片消息 | /messages/v1/card/wecode | |||
| 图片消息 | /messages/v1/image | |||
| 图文消息 | /messages/v1/news | |||
| 小微推送 | 以小微助手形式推送信息,强提醒直达用户 | 小微推送 | /athenaservice/v1/contextaware/push | |
| 考勤打卡 | 打卡数据 | 获取用户的移动打卡数据 | 考勤打卡 | /attendance/v2/records |
| 获取打开数据 | /attendance/v3/records | |||
| 考勤管理 | 管理考勤组、员工考勤班次等信息 | 查询考勤组 | /attendance/v1/group/list | |
| 同步人员考勤组 | /attendance/v1/group/settings | |||
| 创建班次 | /attendance/v1/schedule/setting/create | |||
| 更新班次 | /attendance/v1/schedule/setting/update | |||
| 删除班次 | /attendance/v1/schedule/setting/delete | |||
| 查询班次 | /attendance/v1/schedule/list | |||
| 同步人员排班 | /attendance/v1/group/settings/rules | |||
| 待办接入 | 待办通知 | 将待办事项推送到WeLink | 新增待办任务 | /todo/v1/addtask |
| 更新待办事项 | /todo/v1/updatetask | |||
| 新增待办任务(新) | /todo/v2/addtask | |||
| 更新待办事项(新) | /todo/v2/updatetask | |||
| 删除待办任务(撤销(或完成)指定电子流) | /todo/v1/deltask | |||
| 新增待办任务(新) | /todo/v3/addtask | |||
| 知识管理 | 文章管理 | 上传图片资源。上传后图片仅支持在知识中使用 | 新增文章 | /knowledge/v1/articles/add |
| 更新文章 | /knowledge/v1/articles/update | |||
| 删除文章 | /knowledge/v1/articles/delete | |||
| 新增文章(新) | /knowledge/v2/articles/add | |||
| 更新文章(新) | /knowledge/v2/articles/update | |||
| 查询公告分类 | /knowledge/v1/category/list | |||
| 查询公告组件 | /knowledge/v1/component/list | |||
| 查询公告文章列表 | /knowledge/v1/article/list | |||
| 附件管理 | 对知识附件的管理,包括新增、修改、删除 | 附件上传 | /knowledge/v1/file/upload | |
| 修改附件 | /knowledge/v1/file/update | |||
| 删除附件 | /knowledge/v1/file/delete?fileId={fileId} | |||
| 图片上传 | 上传图片资源。上传后图片仅支持在知识中使用 | 图片上传 | /tinyimage/v2/images | |
| 日历管理 | 日历管理 | 管理企业员工在WeLink中的事件日历、会议日历,包含增删改的操作。 | 新增会议日历 | /calendar/v1/meetings/add |
| 更新会议日历 | /calendar/v1/meetings/update | |||
| 删除会议日历 | /calendar/v1/meetings/delete | |||
| 新增事件日历 | /calendar/v1/events/add | |||
| 事件日历更新 | /calendar/v1/events/update | |||
| 删除事件日历 | /calendar/v1/events/delete | |||
| 会议 | 会议管理 | 创建、更新、取消、查询会议列表、查询历史会议列表及详情 | 预约会议 | /meeting/v1/createconference?userId={userId} |
| 取消预定会议 | /meeting/v1/deleteconference | |||
| 修改预定会议 | /meeting/v1/updateconference | |||
| 查询会议列表 | /meeting/v1/queryconferences | |||
| 查询会议信息 | /meeting/v1/queryconferencedetail | |||
| 查询历史会议列表 | /meeting/v1/queryhistoryconferences | |||
| 查询历史会议信息 | /meeting/v1/queryhistoryconferencedetail | |||
| AI服务 | 文字识别 | 支持证件,票据,表格,名片等图片识别,自动提取关键字段文字内容 | 名片识别 | /aiservice/v1/ocr/business-card |
| 文档识字 | /aiservice/v1/ocr/general-table | |||
| 拍图识字 | /aiservice/v1/ocr/web-image | |||
| 身份证识别 | /aiservice/v1/ocr/id-card | |||
| 票证识别 | /aiservice/v1/ocr/auto-classification | |||
| 人脸识别 | 支持人脸检测和人脸比对,自动提取人脸图像信息,进行身份识别。 | 人脸检测 | /aiservice/v2/frs/face-detect | |
| 人脸比对 | /aiservice/v2/frs/face-compare | |||
| 语音交互 | 支持语音合成、一句话识别,提供语音交互能力。 | 语音识别 | /aiservice/v1/sis/short-audio | |
| 语音评测 | /aiservice/v1/sis/audio-assessment | |||
| 语音合成 | /aiservice/v1/sis/tts | |||
| 自然语言处理 | 支持自然语言处理、生成和理解,提供文本分析及挖掘的能力。 | 文本分词 | /aiservice/v1/nlp/segment | |
| 句向量 | /aiservice/v1/nlp/sentence-embedding | |||
| 命名实体识别 | /aiservice/v1/nlp/ner | |||
| 文本摘要生成 | /aiservice/v1/nlp/summarization | |||
| 文本相似度 | /aiservice/v1/nlp/text-similarity | |||
| 意图理解 | /aiservice/v1/nlp/semantic-parser | |||
| 情感分析 | /aiservice/v1/nlp/sentiment | |||
| 内容审核 | 提供图像、文本和视频的内容审核,进行涉黄、广告、涉政涉暴、涉政敏 | 图片审核 | /aiservice/v1/moderation/image | |
| 文本内容审核 | /aiservice/v1/moderation/text | |||
| 机器翻译 | 支持文本翻译,语种检测,提供不同语种间的快速翻译能力。 | 文本翻译 | /aiservice/v1/translate/translate | |
| 获取已支持的翻译语种 | /aiservice/v1/translate/supported | |||
| 语种检测 | /aiservice/v1/translate/detect | |||
| 直播 | 直播列表 | 查询当前企业的直播间的列表数据 | 直播列表 | /livecast/v1/rooms/list |
| 直播数据 | 获取用户的直播观看数据 | 获取直播间详情 | /livecast/v1/rooms/detail | |
| 获取直播间用户 | /livecast/v1/rooms/audience | |||
| 回看数据 | 查询当前企业的回看数据以及回看观众数据 | 获取直播间回看信息 | /livecast/v1/videos | |
| 获取回看视频的观众 | /livecast/v1/videos/audience | |||
| 审批 | 查询健康打卡数据 | 用于查询企业内健康打卡数据 | 查询健康打卡数据 | /approve/v1/user/health |
| 业务事件回调 | 通讯录变更事件 | 部门变更、部门删除、人员变更、人员销户通知到企业内部应用 | 无 | 无 |
| 企业搜索 | 索引构建 | 新增索引 | 批量新增数据 | /search/v1/indexes/bulk/add |
| 删除索引 | 批量删除数据 | /search/v1/indexes/bulk/del | ||
| 更新索引 | 批量更新数据 | /search/v1/indexes/bulk/edit | ||
| 索引查询 | 搜索企业数据 | 搜索企业数据 | /search/v1/indexes/search | |
| 应用管理 | 应用管理 | 修改应用信息,只支持应用修改自己应用的详情 | 更新应用 | /weopen/wecode/update |
| 应用查询 | 查询当前企业下的应用列表和详情 | 查询应用详情 | /weopen/wecode/detail | |
| 查询应用列表 | /weopen/wecode/list | |||
| 云空间服务 | 外链管理 | 管理云空间外链,包括创建、列举、删除 | 创建文件外链 | /clouddrive/v1/links |
| 查询文件外链 | /clouddrive/v1/links/list | |||
| 删除文件外链 | /clouddrive/v1/links/delete | |||
| 文件下载 | 下载云空间文件 | 获取文件下载地址 | /clouddrive/v1/file/predownload | |
| 文件管理 | 管理云空间文件,包括上传、下载、刷新、删除 | 获取文件上传地址 | /clouddrive/v1/file/preupload | |
| 刷新分片上传任务 | /clouddrive/v1/file/refreshurl | |||
| 蒲公英表单 | 蒲公英表单 | 管理蒲公英表单,包括表单数据以及填写人员范围等 | 查询用户表单列表 | /weopen/form/list |
| 查询表单填写数据 | /weopen/form/data | |||
| 查询表单填写范围 | ||||
| 更新表单填写范围 | /weopen/form/scope |
注意事项
企业变更事件和通讯录变更事件是WeLink调用企业内部应用的后台,将企业内数据变动推送到企业内部应用,具体实现参考业务事件回调。