一、接口简要介绍
企微接口文档是企业微信提供给开发者使用的API接口文档。其主要功能包括:发送应用消息、上传临时素材、获取应用可见范围等。企微接口文档支持RESTful和Websoket两种协议,能够满足大部分的业务需求。下面我们来介绍一下企微接口文档的使用方法。
二、使用流程
企微接口文档的使用流程如下:
1、创建应用,获取应用ID和应用密钥。
/**
* 应用ID
* @type {string}
*/
const appid = 'xxxxxxxxxxxxxxxxx';
/**
* 应用密钥
* @type {string}
*/
const appsecret = 'xxxxxxxxxxxxxxxxx';
2、获取access_token。
/**
* 获取access_token
* @param {string} appid - 应用ID
* @param {string} appsecret - 应用密钥
* @returns {Promise} access_token
*/
async function getAccessToken(appid, appsecret) {
const url = `https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=${appid}&corpsecret=${appsecret}`;
const response = await fetch(url);
const result = await response.json();
return result.access_token;
}
3、发送消息。
/**
* 发送消息
* @param {string} access_token - access_token
* @param {object} message - 消息体
*/
async function sendMessage(access_token, message) {
const url = `https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token=${access_token}`;
const options = {
method: 'POST',
headers: {
'Content-Type': 'application/json',
},
body: JSON.stringify(message),
};
await fetch(url, options);
}
4、上传临时素材。
/**
* 上传临时素材
* @param {string} access_token - access_token
* @param {string} type - 媒体文件类型,分别有图片(image)、语音(voice)和文件(file)
* @param {string} filename - 文件名
* @param {Buffer} buffer - 文件二进制数据
* @returns {Promise