获取应用二维码 - 接口文档 - 企业微信开发者中心

开发者中心

首页

教程

接口

社区

工具

第三方应用开发

快速入门服务端API 客户端API 运营规范附录更新日志联系我们

第三方应用开发服务端API 应用授权接口调用获取应用二维码

获取应用二维码

最后更新：2022/02/15

用于获取第三方应用二维码。

请求方式：POST（HTTPS）
请求地址： https://qyapi.weixin.qq.com/cgi-bin/service/get_app_qrcode?suite_access_token=SUITE_ACCESS_TOKEN

请求包体：

{
	"suite_id":"xxx",
	"appid":1,
	"state":"test",
	"style":0,
	"result_type":1
}

参数说明：

参数	是否必须	说明
suite_access_token	是	第三方应用access_token，获取方法参见获取第三方应用凭证
suite_id	是	第三方应用id（即ww或wx开头的suiteid）
appid	否	第三方应用id，单应用不需要该参数，多应用旧套件才需要传该参数。若不传默认为1
state	否	state值，用于区分不同的安装渠道，可以填写a-zA-Z0-9，长度不可超过32个字节，默认为空。扫应用带参二维码授权安装后，获取企业永久授权码接口会返回该state值
style	否	二维码样式选项，默认为不带说明外框小尺寸。0：带说明外框的二维码，适合于实体物料，1：带说明外框的二维码，适合于屏幕类，2：不带说明外框（小尺寸），3：不带说明外框（中尺寸），4：不带说明外框（大尺寸）。具体样式与服务商管理端获取到的应用二维码样式一一对应，参见下文二维码样式说明
result_type	否	结果返回方式，默认为返回二维码图片buffer。1：二维码图片buffer，2：二维码图片url

权限说明：
要求第三方应用是已上线的第三方通用应用

返回结果：
result_type为1时返回二维码图片buffer（和普通的http下载相同，请根据http头做相应的处理）：

   HTTP/1.1 200 OK
   Connection: close
   Content-Type: image/png 
   Content-disposition: attachment; filename="qrcode.png"
   Date: Sun, 06 Jan 2013 10:20:18 GMT
   Cache-Control: no-cache, must-revalidate
   Content-Length: 339721
   
   Xxxx

result_type为2时用json格式返回图片url

{
	"errcode":0 ,
	"errmsg":"ok" ,
	"qrcode":"xxxxx",
}

参数说明：

参数	说明
errcode	错误码
errmsg	错误描述
qrcode	二维码url地址

二维码样式说明：

适合于实体物料的带说明外框的二维码
适合于屏幕类带说明外框的二维码

不带说明的二维码，有三种不同尺寸

分辨率		最佳扫描距离	适用场景
小尺寸	312×384	0.5m	屏幕类、宣传册等
中尺寸	624×768	1m	海报、展架等
大尺寸	1996×2456	2.5m	幕布、大型广告等

获取应用的管理员列表

明文corpid转换为加密corpid

本节内容

获取应用二维码