完整的企業(yè)微信 API 接口調(diào)用教程：快速調(diào)用

本文通過 access_token 憑證的方式來講解怎么調(diào)用 企業(yè)微信 API，并一步步介紹如何獲取企業(yè)微信 API 的 corpsecret、corpid、access_token 憑證以及怎么向企業(yè)微信的應(yīng)用發(fā)送消息。 企業(yè)微信 API 在線地址為：https://qiyeweixin.apifox.cn/ ，這個在線地址的項目你可以克隆到 Apifox，以方便調(diào)試。話不多說，下面進(jìn)入實操。

企業(yè)微信添加自建應(yīng)用

1、如果你是企業(yè)微信的企業(yè)管理員，點擊 “管理企業(yè)” 進(jìn)入企業(yè)微信后臺（不同版本可能不一樣）

2、然后在 “應(yīng)用管理” 下方，選擇 “創(chuàng)建應(yīng)用”

3、填寫應(yīng)用相關(guān)信息

4、創(chuàng)建成功后，即可看到 Secret 的信息，這個 Secret 就是等會兒要用的 corpsecret。

5、獲取 corpid， 點擊 “我的企業(yè)” 即可看到企業(yè) ID ，這個企業(yè) ID 就是 corpid。

企業(yè)微信獲取access_token 憑證

為方便企業(yè)微信 API 的調(diào)試，下面使用 Apifox 獲取 access_token 憑證。企業(yè)微信API 的 access_token 是應(yīng)用調(diào)用 api 的憑證，由 corpid 和 corpsecret 換取。

請求方式： GET（HTTPS）

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

使用 Apifox 發(fā)送 GET 請求即可得到 access_token（請把截圖中的 corpid、corpsecret 換為自己的 corpid（企業(yè) ID）、應(yīng)用 secret）。企業(yè)微信 API 在線地址為：https://qiyeweixin.apifox.cn/ ，這個在線地址的項目你可以克隆到 Apifox，以方便調(diào)試。

企業(yè)微信發(fā)送應(yīng)用消息

企業(yè)微信的應(yīng)用支持推送文本、圖片、視頻、文件、圖文等類型。

請求方式： POST（HTTPS）

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

企業(yè)微信的 touser

獲取 touser，通訊錄列表的成員賬號就是 touser。

企業(yè)微信的 agentid

每個應(yīng)用都有唯一的 agentid。在“管理后臺”->“應(yīng)用管理”->“應(yīng)用”，點進(jìn)某個應(yīng)用，即可看到 agentid。

構(gòu)造消息體

可以發(fā)送文本、圖片、視頻等多種類型的應(yīng)用消息，這里以最簡單的文本消息為例：（注意修改 touser、agentid 為自己想要的接收者 userid 列表、應(yīng)用 id）

{ "touser" : "abelzhu|ZhuShengben", "msgtype" : "text", "agentid" : 1000002, "text" : { "content" : "我就試一下" }, "safe":0}發(fā)送消息

如下圖示，有了 access_token、touser、agentid和消息體，在 Apifox 中發(fā)送 post 請求即可（紅色箭頭所指為需要注意的點）

如果報錯返回"errcode": 60020，那么你需要配置可信任域名。在“應(yīng)用管理”->“企業(yè)可信 IP”下配置即可。這里需要你下載WW_verify_7x7IN1QfqcsOLA6J.txt文件，并將其放到域名的根目錄下，然后驗證。

響應(yīng)成功

如下圖所示，在企業(yè)微信里，成功響應(yīng)了消息回來。

使用 Apifox 調(diào)試、管理接口

Apifox: 我們團(tuán)隊深入使用兩年的 API 接口調(diào)試工具

Apifox 是一個比 Postman 更強(qiáng)大的接口測試工具，Apifox = Postman + Swagger + Mock + JMeter，Apifox 支持調(diào)試 http (s)、WebSocket、Socket、gRPC、Dubbo 等協(xié)議的接口，并且集成了 IDEA 插件。在開發(fā)完接口后，可以通過 Apifox 的 IDEA 插件一鍵生成接口文檔，多端同步，非常方便測試和維護(hù)。

什么是 gRPC
一個 HTTP 請求需要具備的 5 個要點

欧美日韩午夜_五月天激情综合_国产精品久久久久一区二区三区_色女人av_国产福利av_欧美日韩中

完整的企業(yè)微信 API 接口調(diào)用教程：快速調(diào)用