2014年4月9日 (三) 22:23的最后版本

创建二维码ticket

本接口用来创建二维码ticket

URL

https://api.weibo.com/2/eps/qrcode/create.json

HTTP请求方式

POST

是否需要登录

是
关于登录授权，参见 如何登录授权

接口请求参数

临时二维码请求示例

URL: https://api.weibo.com/2/eps/qrcode/create?access_token=TOKEN
POST数据例子：{"expire_seconds": 1800, "action_name": "QR_SCENE", "action_info": {"scene": {"scene_id": 123123}}}
}

永久二维码请求示例

URL: https://api.weibo.com/2/eps/qrcode/create?access_token=TOKEN
POST数据例子：{"action_name": "QR_LIMIT_SCENE", "action_info": {"scene": {"scene_id": 123}}}

参数详情：

注意事项

• 1、如果action_name=QR_SCENE时，expire_seconds参数空缺，则默认为1800；
• 2、目前有2种类型的二维码，分别是临时二维码和永久二维码，前者有过期时间，最大为1800秒，但能够生成较多数量，后者无过期时间，数量较少（目前参数只支持1--100000）；
• 3、获取带参数的二维码的过程包括两步，首先通过本接口创建二维码ticket，然后凭借ticket到调用qrcode/show接口换取二维码；
• 4、对于临时二维码，过期时间的计时起点是qrcode/create接口的调用时间；
• 5、用户一个未过期扫描带场景值二维码时，可能推送以下两种事件：
  • 如果用户还未关注二维码生成方的官方账号，则扫描后进入关注列表；如果用户点击关注，则微博会给第三方推送如下格式的事件；

{
    "id": 1211260020031346,
    "type": "event",
    "receiver_id": 1902538057,
    "sender_id": 2489518277,
    "created_at": "Mon Jul 16 18:09:20 +0800 2012",
    "text": "扫描二维码",
    "data": {
        "subtype": "scan_follow",
        "key": "action_name_scene_id",
        "ticket": "ticket"
    }
}

• • 如果用户已经关注二维码生成方的官方账号，则扫描后进入和该官方账号的私信对话界面中，并且微博会给第三方推送如下格式的事件；

{
    "id": 1211260020031346,
    "type": "event",
    "receiver_id": 1902538057,
    "sender_id": 2489518277,
    "created_at": "Mon Jul 16 18:09:20 +0800 2012",
    "text": "扫描二维码",
    "data": {
        "subtype": "scan",
        "key": "action_name_scene_id",
        "ticket": "ticket"
    }
}

此接口不得用于推广或引导用户使用任何与新浪微博有直接竞争关系的公司的服务，否则将永久关停指定应用或V用户使用资格。

返回结果

// 成功返回
{
    "ticket": "XXX",
    "expire_seconds": 1800
}

// 失败返回
{
    "request": "/2/eps/qrcode/create.json",
    "error_code": 284XX,
    "error": "error message."
}