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

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

请求方式: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
statestate值,用于区分不同的安装渠道,可以填写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×3840.5m屏幕类、宣传册等
中尺寸624×7681m海报、展架等
大尺寸1996×24562.5m幕布、大型广告等

 

上一篇
获取应用的管理员列表
下一篇
明文corpid转换为加密corpid