资源下载二维码（qrcode）

• 描述
• 接口规格
• 请求
  • 请求语法
• 响应
  • 响应语法
  • 响应状态码
• 附注
• 示例
• 高级用法

描述

资源下载二维码生成功能用于为存放在七牛云存储上的资源的下载URL或资源内容生成二维码图片，方便用户在各种客户端之间传播资源。
所生成的二维码图片格式为png。

接口规格

qrcode/<Mode>/level/<Level>

其中<DownloadURL>代表资源的原始下载URL，请参考下载机制。

注意：L是最低级别的冗余度，H最高。冗余度越高，生成图片体积越大。详情请参考维基百科。

请求

请求语法

GET <DownloadURI>?<接口规格> HTTP/1.1
Host: <DownloadHost>

响应

响应语法

HTTP/1.1 200 OK
Content-Type: image/png

<ImageBinaryData>

如果请求失败，具体信息请参考响应状态码。

响应状态码

附注

二维码的内容实际上是文本，却可存储多种类型的内容，参考具体用例。

示例

1. Mode=0时，基于下载URL生成二维码：

   http://developer.qiniu.com/docs/v6/api/reference/fop/qrcode.html?qrcode
   

   

2. Mode=1时，基于下载URL指向的资源内容生成二维码：

   http://developer.qiniu.com/resource/hello.txt?qrcode/1
   

   

3. 分别用不同的冗余度生成不同尺寸的二维码：

   http://developer.qiniu.com/docs/v6/api/reference/fop/qrcode.html?qrcode/0/level/L
   

   

   http://developer.qiniu.com/docs/v6/api/reference/fop/qrcode.html?qrcode/0/level/H
   

   

   以上两个二维码图片尺寸不同，但表示的内容相同。

高级用法

想生成二维码 + Logo，可以使用七牛云存储的管道和图片水印处理接口操作实现。例如，

http://developer.qiniu.com/resource/hello.txt?qrcode/1/level/M|watermark/1/image/aHR0cDovL3FyY29kZS5xaW5pdWRuLmNvbS93ZWlib2xvZ282LnBuZz9pbWFnZU1vZ3IvdGh1bWJuYWlsLzMyeDMy/gravity/Center/dx/0/dy/0