企业微信 API 接口调用教程:零基础学习企业微信 API 开发

liam
• 阅读 277

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

企业微信 API 接口调用教程:零基础学习企业微信 API 开发

企业微信添加自建应用

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

企业微信 API 接口调用教程:零基础学习企业微信 API 开发

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

企业微信 API 接口调用教程:零基础学习企业微信 API 开发

3、填写应用相关信息

企业微信 API 接口调用教程:零基础学习企业微信 API 开发

4、创建成功后,即可看到 Secret 的信息,这个 Secret 就是等会儿要用的 corpsecret

企业微信 API 接口调用教程:零基础学习企业微信 API 开发

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

企业微信 API 接口调用教程:零基础学习企业微信 API 开发

企业微信获取 access_token 凭证

为方便企业微信 API 的调试,下面使用 Apifox 获取 access_token 凭证。企业微信API 的 access_token 是应用调用 api 的凭证,由 corpid corpsecret 换取。

请求方式: 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/ ,这个在线地址的项目你可以克隆到 Apifox,以方便调试。

企业微信 API 接口调用教程:零基础学习企业微信 API 开发

企业微信发送应用消息

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

请求方式: POST(HTTPS

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

企业微信的 touser

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

企业微信 API 接口调用教程:零基础学习企业微信 API 开发

企业微信的 agentid

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

企业微信 API 接口调用教程:零基础学习企业微信 API 开发

构造消息体

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

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

发送消息

如下图示,有了 access_tokentouser、agentid消息体,在 Apifox 中发送 post 请求即可(红色箭头所指为需要注意的点)

企业微信 API 接口调用教程:零基础学习企业微信 API 开发

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

企业微信 API 接口调用教程:零基础学习企业微信 API 开发

响应成功

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

企业微信 API 接口调用教程:零基础学习企业微信 API 开发

使用 Apifox 调试、管理接口

Apifox 是一个比 Postman 更强大的接口测试工具,Apifox = Postman + Swagger + Mock + JMeter,Apifox 支持调试 http (s)、WebSocket、Socket、gRPC、Dubbo 等协议的接口,并且集成了 IDEA 插件。在开发完接口后,可以通过 Apifox 的 IDEA 插件一键生成接口文档,多端同步,非常方便测试和维护。

企业微信 API 接口调用教程:零基础学习企业微信 API 开发)企业微信 API 接口调用教程:零基础学习企业微信 API 开发

点赞
收藏
评论区
推荐文章
翼
3年前
微信支付 (JSSDK支付)
官方文档微信支付https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter7_7&index6微信授权获取codehttps://developers.weixin.qq.com/doc/offiaccount/OA_Web_Apps/JSSDK.html58准备工作微信公
Wesley13 Wesley13
3年前
SQL语句中发送微信消息
利用EasySQLMAIL的外部接口表功能来发送。可以支持Oracle、SQLServer、MySQL、PostgreSQL、Informix数据库。步骤如下:(1)在数据源的“外部接口功能”中启用“允许从该数据源上的接口表中发送企业微信或钉钉消息”选项,并选择可以用来发消息的企业微信应用(注意记录下应用ID,后面的S
Easter79 Easter79
3年前
three.js
第1章课程介绍介绍了微信小游戏的概念以及相关的由来,从宏观上对于微信小游戏的定位和价值有一个明确的认识第2章微信小游戏平台与特性讲了微信小游戏平台的相关特性,包括微信小游戏工程的建立,微信小游戏开发工具的详细使用,以及微信小游戏相关API的实战等第3章THREEJS与WebGL核心概念通过理论和实战,讲解了什么是webgl、什
Wesley13 Wesley13
3年前
PHP 实现微信小程序敏感图片、内容检测接口
主要是为了调用微信小程序msgSecCheck、imgSecCheck接口。先附上小程序接口说明文档地址:https://developers.weixin.qq.com/miniprogram/dev/api/openapi/seccheck/msgSecCheck.html1、首先要获取a
Stella981 Stella981
3年前
MoChat企业微信开源系统,让开发者快速搭建基于企业微信的私域流量运营系统
“经过行业的实战应用,企业微信已经成为”私域流量“运营的主要工具”尽管现在基于企业微信开发的第三方产品处于一个百家争鸣的时代,但仍旧未能看到一个开源的、真正为企业微信应用开发服务铺路的框架&引擎,此为Mo.Chat开源框架及其团队成员的初衷,做市场上最好用的开源企业微信应用开发框架。Mo.Chat开源框架提供开箱即用的企业微信管理工具,源代码1
Stella981 Stella981
3年前
DevOps的支撑服务:K8s容器管理与应用部署
本文为云计算架构设计群的微课堂原创分享,转载需注明出处:EAII企业架构创新研究院。如需加入微信群参与微课堂、架构设计与讨论直播请直接回复此公众号:“加群姓名公司职位微信号”。大家好,本期微课堂介绍在新一代数字化企业云平台中对于Kubernetes的学习以及使用的总结。
Stella981 Stella981
3年前
DevOps之自动化测试
转载本文需注明出处:EAII企业架构创新研究院,违者必究。如需加入微信群参与微课堂、架构设计与讨论直播请直接回复此公众号:“加群姓名公司职位微信号”。『微信后台回复“DevOps测试”,获取完整PPT下载』大家好,我是冀博,目前负责新一代数字化企业云平台“ThePlatform”
Stella981 Stella981
3年前
DevOps之软件产品管理最佳实践
转载本文需注明出处:EAII企业架构创新研究院,违者必究。如需加入微信群参与微课堂、架构设计与讨论直播请直接回复此公众号:“加群姓名公司职位微信号”。『微信后台回复“SPM”,获取完整PPT下载』大家好,我是王召,现在负责新一代数字化企业云平台“The
不是海碗 不是海碗
1年前
「教程」微信小程序获取地理位置信息自动查询天气预报信息(附详细代码)
引言天气预报是我们日常生活中经常关注的信息之一。通过结合微信小程序的地理位置获取和天气预报查询API,我们可以轻松实现自动获取当前位置的天气信息。本文将详细介绍如何利用微信小程序获取地理位置和经纬度,并通过天气预报查询API获取实时天气和天气预报的步骤和示
LibraHeresy LibraHeresy
1年前
企业微信使用微信 jssdk 实现转发分享功能
前言又接到一个看似简单,实则难受的需求,实现企业微信环境转发H5页面到微信好友和朋友圈,并保留卡片形式。需求简单明了,但是和微信沾边的,都不是一条好走的路。一上手就发现问题了,企微的jssdk它不更新了。兜兜转转发现,好像企微和微信的jssdk统一用@we