有奖捉虫:云通信与企业服务文档专题,速来> HOT

功能描述

对象存储二维码生成功能可根据用户指定的文本信息(URL 或文本),生成对应的二维码或条形码。
注意:
本接口属于 GET 请求,为同步请求方式,需携带签名,具体签名设置请参见 请求签名


授权说明

授权策略中 action 设置为 ci:CreateQRcodeGenerateJob 。查看所有 action

服务开通

使用该功能需提前开通数据万象,并绑定存储桶。详情请参见 绑定存储桶

使用限制

使用该接口时,请先确认相关限制条件。详情请参见 使用限制

费用说明

该接口为付费服务,产生的费用将由数据万象收取,详细计费说明可参见 内容识别费用

请求

请求示例

GET /?ci-process=qrcode-generate&qrcode-content=<qrcode-content>&mode=<mode>&width=<width> HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
说明
Authorization: Auth String(详情请参见 请求签名 文档)。

请求参数

参数名称
描述
类型
是否必选
ci-process
对象存储处理能力,二维码生成参数为 qrcode-generate
String
qrcode-content
可识别的二维码文本信息
String
mode
生成的二维码类型,可选值:0或1。0为二维码,1为条形码,默认值为0
Int
width
指定生成的二维码或条形码的宽度,高度会进行等比压缩
String

请求头

此接口仅使用公共请求头部,详情请参见 公共请求头部 文档。

请求体

该请求无请求体。

响应

响应头

此接口仅返回公共响应头部,详情请参见 公共响应头部 文档。

响应体

该响应体返回为 application/xml 数据,包含完整节点数据的内容展示如下:
<Response>
<ResultImage>
base64编码的图片
</ResultImage>
</Response>
具体的数据内容如下:
节点名称(关键字)
父节点
描述
类型
Response
保存结果的容器
Container
Container 节点 Response 的内容:
节点名称(关键字)
父节点
描述
类型
ResultImage
Response
二维码图片 base64 数据
String

错误码

该请求操作无特殊错误信息,常见的错误信息请参见 错误码 文档。

实际案例

请求

GET /?ci-process=qrcode-generate&qrcode-content=<https://www.example.com>&mode=0&width=200 HTTP/1.1
Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.com
Date: Fri, 10 Apr 2020 09:35:16 GMT
Authorization: q-sign-algorithm=sha1&q-ak=AKIDZfbOAo7cllgPvF9cXFrJD0****&q-sign-time=1497530202;1497610202&q-key-time=1497530202;1497610202&q-header-list=&q-url-param-list=&q-signature=28e9a4986df11bed0255e97ff90500557e0e****

响应

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 414641
Date: Fri, 10 Apr 2020 09:35:16 GMT
Server: tencent-ci
x-cos-request-id: NTk0MjdmODlfMjQ4OGY3XzYzYzhf****



<Response>
<ResultImage>
base64编码的图片
</ResultImage>
</Response>