企业微信入门

配置项

除了 基础信息，其它配置均为可选项，完整的配置项：

{
  // 基础信息
  corp_id: '', // 服务商的 corpid
  provider_secret: '', // 服务商的 Secret
  suite_id: '', // 应用的 SuiteId
  suite_secret: '', // 应用的 Secret
  token: '',  // token
  aes_key: '',// aes_key，如果是明文模式，请不要填写

  // 文件缓存配置
  // SDK包默认使用文件缓存
  file_cache: {
    // 存储路径
    path: './',
    // 目录权限
    dirMode: 0o777,
    // 文件权限
    fileMode: 0o666,
    // 缓存文件后缀
    ext: '.cache'
  },

  // axios 配置
  // 详见：https://github.com/axios/axios?#request-config
  http: {},

  // 请求重试配置
  // 详见：https://github.com/softonic/axios-retry#options
  retry: {},
}

有的时候，你可能需要将配置单独写到一个文件中，可以使用 defineWorkConfig 函数，这样也可以获得编辑器的提示功能。

const { defineWorkConfig } = require('node-easywechat');

const config = defineWorkConfig({
  // ...
});

创建应用

const { Work } = require('node-easywechat');

const app = new Work({
  // ...
});

注：后续文档的示例代码如无特殊说明， app 指的都是该对象实例。

请求客户端

该功能封装了常用的请求方法，可以请求企业微信的任意API。通过 client 发送请求时，SDK包会自动处理 access_token，因此您只需要传递各API所需的业务参数即可。

const client = app.getClient();
const response = await client.get('/cgi-bin/user/get', {
  query: {
    userid: 'xxx',
  }
});

更多说明请参阅：API调用

ProviderAccessToken

provider_access_token 是公众号API调用的必备条件，SDK包会自动获取并缓存它以供使用。如果要获取它的值，可以通过如下方式获取：

const providerAccessToken = app.getProviderAccessToken();
// 获取具体的token内容
const token = await providerAccessToken.getToken();

还可以通过如下方法获取/设置token的键名：

// 获取token的缓存键名
const key = providerAccessToken.getKey();
// 设置token的缓存键名
providerAccessToken.setKey('your_key');

SuiteTicket

你可以通过如下方式获取 suite_ticket：

const suiteTicket = app.getSuiteTicket();
// 获取具体的ticket内容
const ticket = await suiteTicket.getTicket();

开放平台账号

开放平台账号模块，如果要获取账号的基本信息，可以通过如下方式获取：

const account = app.getAccount();

account.getCorpId();
account.getProviderSecret();
account.getToken();
account.getAesKey();

服务端

服务端模块主要用于处理微信向应用服务器发送的消息，主要封装了消息格式转换、加解密、签名验证的功能。可以通过如下方式获取服务端对象：

const server = app.getServer();

更多说明请参阅：服务端

企业微信入门 ​

配置项 ​

创建应用 ​

请求客户端 ​

ProviderAccessToken ​

SuiteTicket ​

开放平台账号 ​

服务端 ​