Vue调用企业微信API详细过程
一、生成签名
1.获取企业ID与Secret
2.获取Access_token
3.获取ticket
二、生成签名以及回调
先捋一下大概的步骤:

1、首先需要从企业微信管理后台拿到 企业ID 和 应用的Secret。

2、通过 企业ID 和 应用的Secret 来生成 access_token。

3、通过 access_token 来获取 ticket。

4、用 ticket + 随机字符串 + 时间戳 + 当前网页url 拼接成一串字符,然后进行sha1加密。

我遇到的坑:
调试的时候可以用vconsole 方便在移动端查看信息
1、本地请求跨域时发布到线上
2、40013:解决:第三方公司配置的公司corpId和提供的企业微信corpId保持一致
3、40093:解决:获取配置传的url必须是当前页面的地址
4、80001:解决:需要第三方配置或后台返回时设置可信域名,并下载对应的.txt文件,然后让后台把.txt文件放到当前页面对应的域名下做根域名校验
下面是详细过程

先引入一下

// 先安装下微信的js-sdk
npm install weixin-js-sdk

// 然后在main.js页面中引入
import wx from ‘weixin-js-sdk’
Vue.prototype.$wx = wx;

一、生成签名
1.获取企业ID与Secret
企业微信后台登录地址:
https://work.weixin.qq.com/wework_admin/frame#profile

踩过的坑:
1、本地解决跨域后线上依然跨域没有请求到对应接口
2、40013:解决:第三方公司配置的公司corpId和提供的企业微信corpId保持一致
3、40093:解决:获取配置传的url必须是当前页面的地址
80001:解决:需要第三方配置或后台返回时设置可信域名,并下载对应的.txt文件,然后让后台把.txt文件放到当前页面对应的域名下做根域名校验

注意事项
签名用的noncestr和timestamp必须与wx.config中的nonceStr和timestamp相同。
签名用的url必须是调用JS接口页面的完整URL。 出于安全考虑,开发者必须在服务器端实现签名的逻辑。 如出现invalid
signature 等错误详见附录4常见错误及解决办法。

企业ID在这里获取
在这里插入图片描述

Secret在这里获取
在这里插入图片描述

2.获取Access_token
请求URL:https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=ID&corpsecret=SECRET

注:此处标注大写的单词ID和SECRET,替换为上一步中的企业ID和Secret。

返回结果:

{
   "errcode":0,
   "errmsg":"",
   "access_token": "accesstoken000001",
   "expires_in": 7200
}

access_token的有效期正常情况下为7200秒(2小时),有效期内重复获取返回相同结果,过期后获取会返回新的access_token。

这里只要能发送上述请求并得到access_token即可。我这里是用的axios + nginx,直接在axios中请求上述地址会报跨域的错误,解决方法是在axios发送请求后在nginx中转到上述地址。

nginx配置参考地址:https://editor.csdn.net/md/?articleId=119735844

3.获取ticket
请求URL:https://qyapi.weixin.qq.com/cgi-bin/get_jsapi_ticket?access_token=ACCESS_TOKEN

注:此处ACCESS_TOKEN,替换为上一步中的ACCESS_TOKEN。

返回结果:

{
    "errcode":0,
    "errmsg":"ok",
    "ticket":"bxLdikRXVbTPdHSM05e5u5sUoXNKd8-41ZO3MhKoyN5OfkWITDGgnr2fwJ0m9E8NYzWKVZvdVtaUgWvsdshFKA",
    "expires_in":7200
}

这里同上只要能发送上述请求并得到ticket即可。

二、生成签名以及回调
所需的参数都拿到了,接下来就是验证签名和回调:
在app.vue的mounted里写

const that = this

// 生成时间戳
var timestamp = getTimestamp()

// 生成的随机字符串
var nonceStr = randomString(16)

// 有效期2小时,用localStorage做本地缓存
localStorage.setItem('timestamp', timestamp)

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

简单说下wx.config方法。必填参数一共5个,

appId就是第一步中获取的企业ID;

timestamp是生成签名时的时间戳,下面写了通用的方法把当前时间转时间戳;

nonceStr是随机字符串,下面也有通用方法;

signature就是签名了;
个人猜测验证签名这一步 就是根据参数手动拼接字符串,然后手动对这个串加密,把加密后的串与参数一起提交。企业微信后台拿到这个加密的串与参数后,会去根据参数再自动生成一次加密的串,两个串一对比,就是验证成功与失败了。

上面调用的方法getTimestamp()和randomString()和getSignature()方法在这里:
上面getSignature()方法中用到的sha1加密用的是js-sha1:

npm install js-sha1
import sha1 from 'js-sha1'

/**
 * 获取当前时间 时间戳
 * @returns {number}
 */
export function getTimestamp() {
  return Date.parse(new Date());
}

/**
 * 获取随机字符串
 * @param len 可指定长度
 * @returns {string}
 */
export function randomString(len) {
  len = len || 32
  var $chars = 'ABCDEFGHJKMNPQRSTWXYZabcdefhijkmnprstwxyz2345678'
  var maxPos = $chars.length
  var pwd = ''
  for (var i = 0; i < len; i++) {
    pwd += $chars.charAt(Math.floor(Math.random() * maxPos))
  }
  return pwd
}

/**
 * 拼接签名字符串
 * @param ticket 通过access_token获取的jsapi_ticket
 * @param noncestr 自己生成的随机字符串
 * @param timestamp 生成签名时的时间戳
 * @returns {*}
 */
export function getSignature(ticket, noncestr, timestamp) {
  let url = window.location.href.split("#")[0]
  let jsapi_ticket = `jsapi_ticket=${ticket}&noncestr=${noncestr}&timestamp=${timestamp}&url=${url}`
  return sha1(jsapi_ticket);
}

最后就是config验证通过后会回调ready方法,下面是拿调用摄像头举例:

  • config信息验证后会执行ready方法,所有接口调用都必须在config接口获得结果之后,
  • config是一个客户端的异步操作,所以如果需要在页面加载时就调用相关接口,则须把相关接口放在ready函数中调用来确保正确执行。
  • 对于用户触发时才调用的接口,则可以直接调用,不需要放在ready函数中。
that.$wx.ready(function () {
  that.$wx.scanQRCode({
    desc: "scanQRCode desc",
    needResult: 1, // 默认为0,扫描结果由企业微信处理,1则直接返回扫描结果,
    scanType: ["qrCode", "barCode"], // 可以指定扫二维码还是条形码(一维码),默认二者都有
    success: function (res) {
      // 业务代码
    },
    error: function (res) {
      // 业务代码
    },
  });
});

原文链接:https://blog.csdn.net/z1761419224/article/details/118751992

Logo

前往低代码交流专区

更多推荐