服务端接口权限申请
概述
为避免保证数据安全，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调用企业内部应用的后台，将企业内数据变动推送到企业内部应用，具体实现参考业务事件回调。
