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

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

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

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

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

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

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

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

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

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

請(qǐng)求方式： GET（HTTPS）

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

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

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

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

請(qǐng)求方式： POST（HTTPS）

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

企業(yè)微信的 touser

獲取 touser，通訊錄列表的成員賬號(hào)就是 touser。

企業(yè)微信的 agentid

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

構(gòu)造消息體

可以發(fā)送文本、圖片、視頻等多種類型的應(yīng)用消息，這里以最簡(jiǎn)單的文本消息為例：（注意修改 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 請(qǐng)求即可（紅色箭頭所指為需要注意的點(diǎn)）

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

響應(yīng)成功

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

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

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

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

什么是 gRPC
一個(gè) HTTP 請(qǐng)求需要具備的 5 個(gè)要點(diǎn)

欧美深夜视频_国产精品99视频_国产精品网站一区_亚洲最大av网

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