微信公众号开发入门须知：开发者认证和获取Access_token

2019-05-24 本文已影响4人我是非著名程序猿

前期准备工作

1、开启公众号开发者模式
  1.1 申请公众号
  1.2 开发者配置
2、AccessToken3、JS接口安全域名

1、开启公众号开发者模式

1.1 申请公众号

微信的开发者文档真的有点丈二和尚摸不着头脑，有点让人迷糊。

做微信公众号开发，先注册微信公众号，最好有一个服务器和一个备过案的域名，不然很多jsapi接口无法调试。

一般情况下，个人注册订阅号，企业注册企业号。

申请公众号

2.2 开发者配置

公众平台官网登录之后，找到“基本配置”菜单栏

开发者配置

这里的服务器配置，是微信发请求到你所填写的服务器地址去验证你是这个==公众号==的开发者的。

url填写：http://外网IP。外网IP。嗯嗯http的端口号固定使用80，不可填写其他。

Token：自主设置，这个token与公众平台wiki中常提的access_token不是一回事。这个token只用于验证开发者服务器。

服务器配置

消息加解密密钥随机生成即可

消息加密模式，开发环境选择明文即可

如果服务器端没有，提交肯定提示失败，或者出现错误。

我是自己有个域名，然后用Nodejs + Express写了一个接口：

api/auth.js

// 第一步认证为开发者
const crypto = require('crypto');
const config = require('../config');


// 微信认证开发者  微信服务器发送请求到你的服务器，做校验，参数都是微信传过来的。
module.exports = auth = (req, res) => {

  //1.获取微信服务器Get请求的参数 signature、timestamp、nonce、echostr
  var signature = req.query.signature,//微信加密签名
    timestamp = req.query.timestamp,//时间戳
    nonce = req.query.nonce,//随机数
    echostr = req.query.echostr;//随机字符串

  //2.将token、timestamp、nonce三个参数进行字典序排序
  // 这里的 config.token 就是上面你自定义的 Token (如：beip***6666)
  var array = [config.token, timestamp, nonce];
  array.sort();

  //3.将三个参数字符串拼接成一个字符串进行sha1加密
  var tempStr = array.join('');
  const hashCode = crypto.createHash('sha1'); //创建加密类型 
  var resultCode = hashCode.update(tempStr, 'utf8').digest('hex'); //对传入的字符串进行加密

  //4.开发者获得加密后的字符串可与signature对比，标识该请求来源于微信
  if (resultCode === signature) {
    res.send(echostr);
  } else {
    res.send('mismatch');
  }
};

这块的逻辑流程图如下：

使用Express搭建你的restfull api服务

app.js

const express = require('express');
const api = require('./api');
const path = require('path');
const app = express();
const port = 3000;

// 这里就是你的认证路由
app.get('/', (req, res) => {
  api.auth(req, res);
});

// listen
app.listen(port, () => {
  console.log(`Server started on localhost:%d`, port);
});

一般你要把你的Node项目升级到你的服务器；

其实就是当做服务器和你的电脑一样就行了，一样要先装一个nodejs(如果不会，可以参考之前的教程，Node项目线上部署), 然后一样启动就行了，比如:

node app.js

这样就启动你项目，http://你的外网ip:3000;

不过微信规定端口必须是80，如果上一步你的port 可以设置80最好，如果不可以的，只能考虑用 Nginx 走下反向代理。

假设以上问题都解决了。

访问 http://你的外网ip，如果浏览器打印了mismatch，说明这个路由走通了

这时候你再回到服务器设置这里，点击按钮，就会提示成功。

那么恭喜你，开始了万里长征的第一步。

2、AccessToken

切记，这是继续开发下去的一个重要步骤，缺少这个访问令牌，一切都将不能进行。

access_token是公众号的全局唯一接口调用凭据，公众号调用各接口时都需使用access_token。开发者需要进行妥善保存。access_token的存储至少要保留512个字符空间。access_token的有效期目前为2个小时，需定时刷新，重复获取将导致上次获取的access_token失效。

公众平台的API调用所需的access_token的使用及生成方式说明：

1、建议公众号开发者使用中控服务器统一获取和刷新access_token，其他业务逻辑服务器所使用的access_token均来自于该中控服务器，不应该各自去刷新，否则容易造成冲突，导致access_token覆盖而影响业务；

2、目前access_token的有效期通过返回的expire_in来传达，目前是7200秒之内的值。中控服务器需要根据这个有效时间提前去刷新新access_token。在刷新过程中，中控服务器可对外继续输出的老access_token，此时公众平台后台会保证在5分钟内，新老access_token都可用，这保证了第三方业务的平滑过渡；

3、access_token的有效时间可能会在未来有调整，所以中控服务器不仅需要内部定时主动刷新，还需要提供被动刷新access_token的接口，这样便于业务服务器在API调用获知access_token已超时的情况下，可以触发access_token的刷新流程。

公众号和小程序均可以使用AppID和AppSecret调用本接口来获取access_token。AppID和AppSecret可在“微信公众平台-开发-基本配置”页中获得（需要已经成为开发者，且帐号没有异常状态）。调用接口时，请登录“微信公众平台-开发-基本配置”提前将服务器IP地址添加到IP白名单中，点击查看设置方法，否则将无法调用成功。小程序无需配置IP白名单。

接口调用请求说明

https请求方式: GET
https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET

参数说明

参数	是否必须	说明
grant_type	是	获取access_token填写client_credential
appid	是	第三方用户唯一凭证
secret	是	第三方用户唯一凭证密钥，即appsecret

返回说明

正常情况下，微信会返回下述JSON数据包给公众号：

{"access_token":"ACCESS_TOKEN","expires_in":7200}

参数说明

参数	说明
access_token	获取到的凭证
expires_in	凭证有效时间，单位：秒

错误时微信会返回错误码等信息，JSON数据包示例如下（该示例为AppID无效错误）:

{"errcode":40013,"errmsg":"invalid appid"}

返回码说明

返回码	说明
-1	系统繁忙，此时请开发者稍候再试
0	请求成功
40001	AppSecret错误或者AppSecret不属于这个公众号，请开发者确认AppSecret的正确性
40002	请确保grant_type字段值为client_credential
40164	调用接口的IP地址不在白名单中，请在接口IP白名单中进行设置。（小程序及小游戏调用不要求IP地址在白名单内。）