智能多媒体 API

  • 资源下载二维码

    最近更新时间:2018-01-18 18:06:07

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

    接口规格

    qrcode/<Mode>/level/<Level>
    
    参数名称 说明 必填
    <Mode> 可选值:0,为 DownloadURL 本身生成二维码,显示DownloadURL和DownloadURL指向的资源内容。1,为 DownloadURL 指向的资源内容生成二维码,只显示资源内容,不显示DownloadURL。

    默认为0

    /level/<Level> 冗余度,可选值L(7%)、M(15%)、Q(25%),H(30%),默认为L

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

    注意:L是最低级别的冗余度,H最高。冗余度越高,生成图片体积越大。

    请求语法

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

    响应语法

    HTTP/1.1 200 OK
    Content-Type: image/png
    
    <ImageBinaryData>
    

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

    响应状态码

    HTTP状态码 含义
    200 二维码生成成功
    400 请求语法错误
    404 资源不存在
    599 服务端操作失败。

    如遇此错误,请将完整错误信息(包括所有HTTP响应头部)通过 工单 提交给我们。

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

    示例

    • Mode=0时,基于下载URL生成二维码:
    https://odum9helk.qnssl.com/Fjjtqd7mL4DrqA33Ew8FdHg-NeNH?qrcode
    

    点击察看图片

    • Mode=1时,基于下载URL指向的资源内容生成二维码:
    https://odum9helk.qnssl.com/Fjjtqd7mL4DrqA33Ew8FdHg-NeNH?qrcode/1
    

    点击察看图片

    • 分别用不同的冗余度生成不同尺寸的二维码:
    https://odum9helk.qnssl.com/Fjjtqd7mL4DrqA33Ew8FdHg-NeNH?qrcode/0/level/L
    

    点击察看图片

    https://odum9helk.qnssl.com/Fjjtqd7mL4DrqA33Ew8FdHg-NeNH?qrcode/0/level/H
    

    点击察看图片

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

    高级用法

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

    https://odum9helk.qnssl.com/Fjjtqd7mL4DrqA33Ew8FdHg-NeNH?qrcode/1/level/M|watermark/1/image/aHR0cDovL3FyY29kZS5xaW5pdWRuLmNvbS93ZWlib2xvZ282LnBuZz9pbWFnZU1vZ3IvdGh1bWJuYWlsLzMyeDMy/gravity/Center/dx/0/dy/0
    

    QRCode+Logo

    以上内容是否对您有帮助?
  • Close