更新时间:2023-12-18 GMT+08:00
分享

服务端接口权限申请

概述

为避免保证数据安全,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/detail

更新表单填写范围

/weopen/form/scope

注意事项

企业变更事件通讯录变更事件是WeLink调用企业内部应用的后台,将企业内数据变动推送到企业内部应用,具体实现参考业务事件回调。

分享:

    相关文档

    相关产品