调用DetectImageQRCodes接口检测图片中二维码的位置和内容。

接口说明

该接口不依赖媒体集。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String DetectImageQRCodes

操作接口名称,固定取值为DetectImageQRCodes。

ImageUri String oss://imm-test/testcases/QRcodetest.jpg

图片的OSS URI。

OSS地址规则为oss://bucket/object,其中bucket为和当前项目处于同一区域的OSS Bucket名称,object为文件路径。

Project String immimagetest

项目名称。

RegionId String cn-hangzhou

项目所在地域的ID。

地域Endpoint格式为imm.RegionId.aliyuncs.com,例如当RegionId为cn-hangzhou时,地域Endpoint为imm.cn-hangzhou.aliyuncs.com。

返回数据

名称 类型 示例值 描述
ImageUri String oss://imm-test/testcases/QRcodetest.jpg

图片的OSS URI。

QRCodes Array of QRCodes

识别出的二维码信息。

目前最多只能返回一个二维码。

Content String https://www.aliyun.com/product/imm

二维码内容。

QRCodeBoundary Struct

二维码位置框。

Height Integer 706

二维码位置框高度。单位为px。

Left Integer 460

顶点X坐标,距离左端距离。单位为px。

Top Integer 295

顶点Y坐标,距离顶端距离。单位为px。

Width Integer 741

二维码位置框宽度。单位为px。

RequestId String 52D33EAE-88B2-4ADE-A5DB-18BD426617A5

当次请求的Request ID。

示例

请求示例

http(s)://[Endpoint]/?Action=DetectImageQRCodes
&ImageUri=oss://imm-test/testcases/QRcodetest.jpg
&Project=immimagetest
&<公共请求参数>

正常返回示例

XML 格式

<RequestId>52D33EAE-88B2-4ADE-A5DB-18BD426617A5</RequestId>
<ImageUri>oss://imm-test/testcases/QRcodetest.jpg</ImageUri>
<QRCodes>
    <Content>https://www.aliyun.com/product/imm</Content>
    <QRCodeBoundary>
        <Left>460</Left>
        <Top>295</Top>
        <Height>706</Height>
        <Width>741</Width>
    </QRCodeBoundary>
</QRCodes>

JSON 格式

{
    "RequestId": "52D33EAE-88B2-4ADE-A5DB-18BD426617A5",
    "ImageUri": "oss://imm-test/testcases/QRcodetest.jpg",
    "QRCodes": [
		{
			"Content": "https://www.aliyun.com/product/imm",
			"QRCodeBoundary": {
				"Left": 460,
				"Top": 295,
				"Height": 706,
				"Width": 741
			}
		}
	]
}