vue项目接入企业微信SDK

所有的JS接口只能在企业微信应用的可信域名下调用(包括子域名),且可信域名必须有ICP备案且在管理端验证域名归属

1. 需要有ICP备案的域名

2. 验证域名归属

企业微信管理端→应用管理→某个应用→设置可信域名(页面最下方)
vue项目接入企业微信SDK_第1张图片
填写可信域名后,点击申请校验域名vue项目接入企业微信SDK_第2张图片
按照提示操作,将下载的文件上传至域名根目录下,并确保可以访问,完成后点击确定,完成域名归属验证
vue项目接入企业微信SDK_第3张图片

3. 俩种注入方式

企业级注入:wx.config注入的是企业的身份与权限;
应用级注入:wx.agentConfig注入的是应用的身份与权限;(貌似只能企业微信里使用)
config注入的是企业的身份与权限,而agentConfig注入的是应用的身份与权限。尤其是当调用者为第三方服务商时,通过config无法准确区分出调用者是哪个第三方应用,而在部分场景下,又必须严谨区分出第三方应用的身份,此时即需要通过agentConfig来注入应用的身份信息。
调用agentConfig的注意事项:
agentConfig与config的签名算法完全一样,但是jsapi_ticket的获取方法不一样,请特别注意,查看”获取应用身份的ticket“.
调用wx.agentConfig之前,必须确保先成功调用wx.config
当前页面url中的域名必须是在该应用中设置的可信域名。
agentConfig仅在企业微信2.5.0及以后版本支持,微信侧不支持(微信开发者工具也不支持)。

4. 数据准备

corpid

每个企业都拥有唯一的corpid,获取此信息可在管理后台“我的企业”-“企业信息”下查看“企业ID”(需要有管理员权限)

vue项目接入企业微信SDK_第4张图片

agentid

每个应用都有唯一的agentid。在管理后台->“应用与小程序”->“应用”,点进某个应用,即可看到agentid。

vue项目接入企业微信SDK_第5张图片

secret

secret是企业应用里面用于保障数据安全的“钥匙”,每一个应用都有一个独立的访问密钥,为了保证数据的安全,secret务必不能泄漏。

目前secret有:

(1)、自建应用secret。在管理后台->“应用与小程序”->“应用”->“自建”,点进某个应用,即可看到。
(2)、基础应用secret。某些基础应用(如“审批”“打卡”应用),支持通过API进行操作。在管理后台->“应用与小程序”->“应用->”“基础”,点进某个应用,点开“API”小按钮,即可看到。

vue项目接入企业微信SDK_第6张图片
(3)、通讯录管理secret。在“管理工具”-“通讯录同步”里面查看(需开启“API接口同步”);
(4)、外部联系人管理secret。在“客户联系”栏,点开“API”小按钮,即可看到。

vue项目接入企业微信SDK_第7张图片
access_token access_token是企业后台去企业微信的后台获取信息时的重要票据,由corpid和secret产生。所有接口在通信时都需要携带此信息用于验证接口的访问权限

5. 获取access_token

获取access_token是调用企业微信API接口的第一步,相当于创建了一个登录凭证,其它的业务API接口,都需要依赖于access_token来鉴权调用者身份。
因此开发者,在使用业务接口前,要明确access_token的颁发来源,使用正确的access_token。

你可能感兴趣的:(vue)