本文通过 **access_token** 凭证的方式来讲解怎么调用 **[企业微信 API](https://apifox.com/apiskills/qiyeweixin-api-debug/)**，并一步步介绍如何获取企业微信 API 的 **corpsecret**、**corpid、access_token 凭证**以及怎么向企业微信的应用**发送消息。** 企业微信 API 在线地址为：https://qiyeweixin.apifox.cn/ ，这个在线地址的项目你可以克隆到 Apifox，以方便调试。话不多说，下面进入实操。

![alt](https://uploadfiles.nowcoder.com/images/20230922/402685756_1695365218982/AD1A1B7183951DC89F508A6B6C422144)

## 企业微信添加自建应用

1、如果你是企业微信的企业管理员，点击 **“管理企业”** 进入企业微信后台（不同版本可能不一样）

![alt](https://uploadfiles.nowcoder.com/images/20230922/402685756_1695365224997/AD1A1B7183951DC89F508A6B6C422144)

2、然后在 **“应用管理”** 下方，选择 **“创建应用”**

![alt](https://uploadfiles.nowcoder.com/images/20230922/402685756_1695365229593/AD1A1B7183951DC89F508A6B6C422144)

3、填写应用相关信息

![alt](https://uploadfiles.nowcoder.com/images/20230922/402685756_1695365234251/AD1A1B7183951DC89F508A6B6C422144)

4、创建成功后，即可看到 **Secret** 的信息，这个 Secret 就是等会儿要用的 [corpsecret](https://developer.work.weixin.qq.com/document/path/90487#14953/secret)。

![alt](https://uploadfiles.nowcoder.com/images/20230922/402685756_1695365242064/AD1A1B7183951DC89F508A6B6C422144)

5、获取 **corpid，** 点击 **“我的企业”** 即可看到企业 ID ，这个企业 ID 就是 **corpid**。

![alt](https://uploadfiles.nowcoder.com/images/20230922/402685756_1695365246894/AD1A1B7183951DC89F508A6B6C422144)

## 企业微信获取 **access_token** 凭证

为方便企业微信 API 的调试，下面使用 **[Apifox](https://apifox.com/apiskills/interface-debugging-tools/)**  获取 access_token 凭证。企业微信API 的 access_token 是应用调用 api 的凭证，由 [corpid ](https://developer.work.weixin.qq.com/document/path/90487#14953/corpid)和[ corpsecret ](https://developer.work.weixin.qq.com/document/path/90487#14953/secret)换取。

> **请求方式：** GET（**HTTPS**）

> **请求 URL：** https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=ID&corpsecret=SECRET

使用 Apifox 发送 GET 请求即可得到 access_token（请把截图中的 corpid、corpsecret 换为自己的 corpid（企业 ID）、应用 secret）。企业微信 API 在线地址为：**<https://qiyeweixin.apifox.cn/>** ，这个[在线地址](https://qiyeweixin.apifox.cn/)的项目你可以克隆到 [Apifox](https://apifox.com/apiskills/interface-debugging-tools/)，以方便调试。

![alt](https://uploadfiles.nowcoder.com/images/20230922/402685756_1695365256397/AD1A1B7183951DC89F508A6B6C422144)

## 企业微信发送应用消息

企业微信的应用支持推送文本、图片、视频、文件、图文等类型。

> **请求方式：** POST（**HTTPS**）

> **请求地址：** https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token=ACCESS_TOKEN

### 企业微信的 touser

获取 **touser**，通讯录列表的成员账号就是 touser。

![alt](https://uploadfiles.nowcoder.com/images/20230922/402685756_1695365263917/AD1A1B7183951DC89F508A6B6C422144)

### 企业微信的 agentid

每个应用都有唯一的 **agentid**。在“管理后台”->“应用管理”->“应用”，点进某个应用，即可看到 agentid。

![alt](https://uploadfiles.nowcoder.com/images/20230922/402685756_1695365273522/AD1A1B7183951DC89F508A6B6C422144)

### 构造消息体

可以发送文本、图片、视频等多种类型的应用消息，这里以最简单的文本消息为例：（注意修改 touser、agentid 为自己想要的接收者 userid 列表、应用 id）

```
{
   "touser" : "abelzhu|ZhuShengben",
   "msgtype" : "text",
   "agentid" : 1000002,
   "text" : {
       "content" : "我就试一下"
   },
   "safe":0
}
```

### 发送消息

如下图示，有了 **access_token**、**touser、agentid**和**消息体**，在 Apifox 中发送 post 请求即可（红色箭头所指为需要注意的点）

![alt](https://uploadfiles.nowcoder.com/images/20230922/402685756_1695365279599/AD1A1B7183951DC89F508A6B6C422144)

如果报错返回`"errcode": 60020`，那么你需要配置可信任域名。在“应用管理”->“企业可信 IP”下配置即可。这里需要你下载`WW_verify_7x7IN1QfqcsOLA6J.txt`文件，并将其放到域名的根目录下，然后验证。

![alt](https://uploadfiles.nowcoder.com/images/20230922/402685756_1695365284192/AD1A1B7183951DC89F508A6B6C422144)

### 响应成功

如下图所示，在企业微信里，成功响应了消息回来。

![alt](https://uploadfiles.nowcoder.com/images/20230922/402685756_1695365288429/AD1A1B7183951DC89F508A6B6C422144)

## 使用 Apifox 调试、管理接口

**Apifox** 是一个比 Postman 更强大的接口测试工具，Apifox = Postman + Swagger + Mock + JMeter，Apifox 支持调试 **[http](https://apifox.com/apiskills/the-5-pillars-of-every-http-request/)** (s)、WebSocket、Socket、**[gRPC](https://apifox.com/apiskills/introduction-to-grpc/)**、Dubbo 等协议的接口，并且集成了 [IDEA 插件](https://apifox.com/apiskills/apifox-auto-generates-api-docs/)。在开发完接口后，可以通过 Apifox 的 IDEA 插件一键生成接口文档，多端同步，非常方便测试和维护。

![](https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/b85e56e8ddd34ad5abab4a56ed6c1641~tplv-k3u1fbpfcp-jj-mark:0:0:0:0:q75.image#?w=1280&h=755&s=264692&e=png&b=35383b)![](https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/4645c4fc2d62427da30389600268c7f2~tplv-k3u1fbpfcp-jj-mark:0:0:0:0:q75.image#?w=1280&h=810&s=414796&e=png&a=1&b=1f2025)

企业微信 API 接口调用教程：一步步学习企业微信 API 的使用技巧

总共已有 0 条评论