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

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

alt

企业微信添加自建应用

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

alt

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

alt

3、填写应用相关信息

alt

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

alt

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

alt

企业微信获取 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,以方便调试。

alt

企业微信发送应用消息

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

请求方式: POST(HTTPS

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

企业微信的 touser

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

alt

企业微信的 agentid

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

alt

构造消息体

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

1{ 2 "touser" : "abelzhu|ZhuShengben", 3 "msgtype" : "text", 4 "agentid" : 1000002, 5 "text" : { 6 "content" : "我就试一下" 7 }, 8 "safe":0 9}

发送消息

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

alt

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

alt

响应成功

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

alt

使用 Apifox 调试、管理接口

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

点赞
收藏

评论区

加载中...

相关推荐

微信支付 (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准备工作微信公

SQL语句中发送微信消息

利用EasySQLMAIL的外部接口表功能来发送。可以支持Oracle、SQLServer、MySQL、PostgreSQL、Informix数据库。步骤如下:(1)在数据源的“外部接口功能”中启用“允许从该数据源上的接口表中发送企业微信或钉钉消息”选项,并选择可以用来发消息的企业微信应用(注意记录下应用ID,后面的S

three.js

第1章课程介绍介绍了微信小游戏的概念以及相关的由来,从宏观上对于微信小游戏的定位和价值有一个明确的认识第2章微信小游戏平台与特性讲了微信小游戏平台的相关特性,包括微信小游戏工程的建立,微信小游戏开发工具的详细使用,以及微信小游戏相关API的实战等第3章THREEJS与WebGL核心概念通过理论和实战,讲解了什么是webgl、什

PHP 实现微信小程序敏感图片、内容检测接口

主要是为了调用微信小程序msgSecCheck、imgSecCheck接口。先附上小程序接口说明文档地址:https://developers.weixin.qq.com/miniprogram/dev/api/openapi/seccheck/msgSecCheck.html1、首先要获取a

MoChat企业微信开源系统,让开发者快速搭建基于企业微信的私域流量运营系统

“经过行业的实战应用,企业微信已经成为”私域流量“运营的主要工具”尽管现在基于企业微信开发的第三方产品处于一个百家争鸣的时代,但仍旧未能看到一个开源的、真正为企业微信应用开发服务铺路的框架&引擎,此为Mo.Chat开源框架及其团队成员的初衷,做市场上最好用的开源企业微信应用开发框架。Mo.Chat开源框架提供开箱即用的企业微信管理工具,源代码1

DevOps的支撑服务:K8s容器管理与应用部署

本文为云计算架构设计群的微课堂原创分享,转载需注明出处:EAII企业架构创新研究院。如需加入微信群参与微课堂、架构设计与讨论直播请直接回复此公众号:“加群姓名公司职位微信号”。大家好,本期微课堂介绍在新一代数字化企业云平台中对于Kubernetes的学习以及使用的总结。