企微开发踩坑指南

前言

基于企微平台的 web 开发属于 app hybrid 开发的一个典型场景，使用企业微信官方提供的 JS-SDK ,我们可以借助企业微信高效地使用拍照、选图、语音、位置等手机系统的能力，同时可以直接使用企业微信分享、扫一扫等企业微信特有的能力，为企业微信用户提供更优质的网页体验。

其主要的优势在于全平台、以及结合企微实现智能营销；目前企微官方提供了三种场景供我们选择，本文介绍的是基于 JS-SDK 的企业内部应用。

企微开发踩坑指南_JavaScript

企微开发踩坑指南_微信_02

前端这块前期大概率遇到的坑有这些：

1.鉴权

2.技术栈选择、本地调试、企微 webview 的兼容性

登录鉴权流程

企微上的应用开发，是通过 webview 来实现的，和常见的混合开发模式一致，只要登录流程完成后，后面的业务开发过程就是我们熟悉的 html,js 等前端技术了。

若想使用企微的 api, 需要首先加载并注册 JS-SDK，它是一个 js 文件所以加载可以通过 script 标签的形式来引入，加载完后需要注册才能使用，其官方提供的注册函数如下

wx.config({
    beta: true,// 必须这么写，否则wx.invoke调用形式的jsapi会有问题
    debug: true, // 开启调试模式,调用的所有api的返回值会在客户端alert出来，若要查看传入的参数，可以在pc端打开，参数信息会通过log打出，仅在pc端时才会打印。
    appId: '', // 必填，企业微信的corpID
    timestamp: , // 必填，生成签名的时间戳
    nonceStr: '', // 必填，生成签名的随机串
    signature: '',// 必填，签名，见 附录-JS-SDK使用权限签名算法
    jsApiList: [] // 必填，需要使用的JS接口列表，凡是要调用的接口都需要传进来
});

wx.agentConfig({
    corpid: '', // 必填，企业微信的corpid，必须与当前登录的企业一致
    agentid: '', // 必填，企业微信的应用id （e.g. 1000247）
    timestamp: , // 必填，生成签名的时间戳
    nonceStr: '', // 必填，生成签名的随机串
    signature: '',// 必填，签名，见附录-JS-SDK使用权限签名算法
    jsApiList: ['selectExternalContact'], //必填，传入需要使用的接口名称
    success: function(res) {
        // 回调
    },
    fail: function(res) {
        if(res.errMsg.indexOf('function not exist') > -1){
            alert('版本过低请升级')
        }
    }
});

config 接口是注册当前企业权限，而agengConfig 是当前应用权限，它们的签名算法是完全一样的，整体流程大概如下：

access_token =》jsapi_ticket => signature =》wx.config、wx.agentConfig 注册，这里面涉及到几个流程：

1、access_token：调用接口凭证, 用于获取 jsapi_ticket, 一般由业务后端来缓存，不放在前端。

2、jsapi_ticket：H5应用调用企业微信JS接口的临时票据，正常情况下，jsapi_ticket的有效期为7200秒，通过access_token来获取。由于获取jsapi_ticket的api调用次数非常有限（一小时内，一个企业最多可获取400次，且单个应用不能超过100次），频繁刷新jsapi_ticket会导致api调用受限，影响自身业务，开发者必须在自己的服务全局缓存jsapi_ticket。

3、signature：签名，具体见附录-JS-SDK使用权限签名算法

4、config 函数执行完会触发全局 wx.ready 函数，agentConfig 需要在这个钩子里调用。️

5、签名信息，默认的有效期为 7200 秒，也就是2小时，前端可以保存下，控制下更新频率。