依据当前公开 OpenAPI 自动生成

企业微信 API 接口目录

青鸾当前公开的 97 个企业微信 API 接口,覆盖登录、长连接、消息、联系人、群聊、朋友圈、文件、账号与事件回调。接口路径以 /qingluan/ 开头,实例字段统一使用 appid。

进入控制台 交互式 API 文档
97 个当前接口9 类能力更新:2026-09-10

文件 7 个

上传和下载图片、视频、普通文件与大文件

其他 4 个

企业微信接口能力

联系人 15 个

同步通讯录、查询用户资料、搜索与维护联系人

登录与扫码 6 个

获取登录二维码、查询扫码状态、提交验证码、重连与退出登录

朋友圈 8 个

发布、查询、点赞、评论与删除朋友圈内容

长连接 4 个

查询企业微信实例的长连接状态

消息 24 个

拉取消息以及发送文本、图片、文件、语音、视频、卡片与群发消息

账号 3 个

查询和修改账号资料、获取本人二维码

群聊 25 个

查询和维护群资料、成员、群公告、群主与群设置

实例与回调 1 个

为指定 appid 配置事件回调地址与验签密钥

接入约定

业务接口请求头携带 QL-Key,请求体用 appid 指定实例。能力层响应以 code=0 判断成功。

历史 URL 会继续保留为迁移说明,但不会进入搜索索引;请从本目录进入当前接口。

常见问题

当前企业微信 API 路径是什么?

当前公开接口统一位于 /qingluan/**。本页和各接口页均由网关公开 OpenAPI 自动生成。

如何指定企业微信实例?

在 JSON 请求体中使用 appid。该值可在开发者控制台的实例与回调页面取得。

怎样判断接口调用成功?

能力层返回需要读取业务字段 code;code=0 表示业务成功,不能只根据 HTTP 200 判断。

开始接入

创建 API Key、接入账号并通过在线测试核对请求和响应。

打开开发者控制台