获取应用二维码

POST

https://qyapi.weixin.qq.com/cgi-bin/service/get_app_qrcode

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

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

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

二维码样式说明：

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

适合于屏幕类带说明外框的二维码

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

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

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://qyapi.weixin.qq.com/cgi-bin/service/get_app_qrcode' \
--header 'Content-Type: application/json' \
--data-raw '{
	"suite_id":"xxx",
	"appid":1,
	"state":"test",
	"style":0,
	"result_type":1
}'

响应示例

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

请求参数

Query 参数

suite_access_token

string

可选

第三方应用access_token，获取方法参见获取第三方应用凭证

示例值:

SUITE_ACCESS_TOKEN

Body 参数application/json

suite_id

string

必需

第三方应用id（即ww或wx开头的suiteid）

appid

integer

可选

第三方应用id，单应用不需要该参数，多应用旧套件才需要传该参数。若不传默认为1

state

string

可选

state值，用于区分不同的安装渠道，可以填写a-zA-Z0-9，长度不可超过32个字节，默认为空。扫应用带参二维码授权安装后，获取企业永久授权码接口会返回该state值

style

integer

可选

二维码样式选项，默认为不带说明外框小尺寸。0：带说明外框的二维码，适合于实体物料，1：带说明外框的二维码，适合于屏幕类，2：不带说明外框（小尺寸），3：不带说明外框（中尺寸），4：不带说明外框（大尺寸）。具体样式与服务商管理端获取到的应用二维码样式一一对应，参见下文二维码样式说明

result_type

integer

可选

结果返回方式，默认为返回二维码图片buffer。1：二维码图片buffer，2：二维码图片url

示例

返回响应

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

application/json

Body

errcode

integer

错误码

必需

errmsg

string

错误描述

必需

qrcode

string

二维码url地址

必需

修改于 2022-12-05 04:16:22

通讯录权限体系

明文corpid转换为加密corpid