为了满足用户推广分析的需要，公众平台提供了生成带参数二维码的接口。使用该接口可以获得多个带不同场景值的二维码，用户扫描后，公众号可以接收到事件。这种二维码可用于区分统计不同的用户来源等场景。

目前有二种类型的二维码：

临时二维码，有过期时间，最大为1800秒，但能够生成较多数量；

永久二维码，无过期时间，数量较少（目前参数只支持1~1000）。

用户扫描带场景值二维码时，公众号可接收以下两种事件：

如果用户还未关注公众号，则用户可以关注公众号，关注后易信会将带场景值关注事件推送给开发者。

如果用户已经关注公众号，在用户扫描后会自动进入会话，易信也会将带场景值扫描事件推送给开发者。

获取带参数的二维码的过程包括两步，首先创建二维码ticket，然后凭借ticket到指定URL换取二维码。

目录

[隐藏]1请求说明

2请求参数

3返回说明

4返回参数

5异常返回说明

6请求说明

7请求参数

8返回说明

请求说明

临时二维码请求说明

http请求方式:POST

URL:https://api.yixin.im/cgi-bin/qrcode/create?access_token=TOKEN

POST数据格式：json

POST数据例子：{"expire_seconds":1800,"action_name":"QR_SCENE","action_info":{"scene":{"scene_id":123}}}

永久二维码请求说明

http请求方式:POST

URL:https://api.yixin.im/cgi-bin/qrcode/create?access_token=TOKEN

POST数据格式：json

POST数据例子：{"action_name":"QR_LIMIT_SCENE","action_info":{"scene":{"scene_id":123}}}

请求参数

参数是否必须描述

access_token是调用接口凭证

expire_seconds否该二维码有效时间，以秒为单位。最大不超过1800。

action_name是二维码类型，QR_SCENE为临时,QR_LIMIT_SCENE为永久

action_info是二维码详细信息

scene_id是场景值ID，临时二维码时为32位整型，永久二维码时最大值为1000

返回说明

{"ticket":"gQG28DoAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL0FuWC1DNmZuVEhvMVp4NDNMRnNRAAIEesLvUQMECAcAAA==","expire_seconds":1800}

返回参数

参数描述

ticket获取的二维码ticket，凭借此ticket可以在有效时间内换取二维码。

expire_seconds二维码的有效时间，以秒为单位。最大不超过1800。

异常返回说明

{"errcode":40013,"errmsg":"invalidappid"}

全局返回码说明

通过ticket换取二维码

请求说明

http请求方式:GET

URL:https://api.yixin.im/cgi-bin/qrcode/showqrcode?ticket=TICKET

请求参数

参数是否必须描述

ticket是获取的二维码ticket，凭借此ticket可以在有效时间内换取二维码

返回说明

ticket正确情况下，http返回码是200，是一张图片，可以直接展示或者下载。

HTTP头（示例）如下：

Accept-Ranges:bytes

Cache-Control:max-age=604800

Connection:keep-alive

Content-Length:3874

Content-Type:image/png

Date:Mon,06Jan201403:25:43GMT

Expires:Mon,13Jan201403:25:43GMT

Server:nginx/1.2.1

错误情况下（如ticket非法）返回HTTP错误码404。