DetectQRCodes二维码检测
更新
建议换用 DetectImageQRCodes 接口,获得更统一、便捷的使用体验。
当前接口将择日废弃。
描述
检测图片中的二维码,并返回二维码的位置。
请求参数
名称 | 类型 | 是否必填 | 描述 |
---|---|---|---|
Project | String | 是 | 项目名 |
Action | String | 是 | DetectQRCodes |
SrcUris | String | 是 | 图片源的存储位置,例如 OSS 资源”oss://bucket1/a.jpg” 。 以 JSON 字符串的方式表示,例如: [“oss://bucket1/1.jpg”] OSS 地址规则为: oss://bucket/object ,其中 bucket 为和当前 Project 在同一区域的 OSS 桶名, object 为文件路径。当前仅支持1张图片。 |
返回参数
名称 | 类型 | 描述 |
---|---|---|
RequestId | String | 用户发送的每次接口调用请求,无论成功与否,系统都会返回一个唯一识别码 RequestId 给用户 |
SuccessDetails | Array | 成功项目列表 SuccessDetail 的数组 |
FailDetails | Array | 失败项目项列表 FailDetail 的数组 |
成功项目详情SuccessDetail
名称 | 类型 | 描述 |
---|---|---|
SrcUri | String | 图片源的存储位置 |
QRCodes | Array | 图片中检测到的二维码详情QRCodes数组 |
二维码详情QRCodes
名称 | 类型 | 描述 |
---|---|---|
QRCodesRectangle | Object | 二维码矩形框 QRCodesRectangle |
Content | string | 二维码内容 |
二维码矩形框QRCodesRectangle
名称 | 类型 | 描述 |
---|---|---|
Left | Int | 左上角横坐标 |
Top | Int | 左上角纵坐标 |
Width | Int | 宽度 |
Height | Int | 高度 |
失败项目项详情FailDetail
名称 | 类型 | 描述 |
---|---|---|
SrcUri | String | 相片源的存储位置 |
Reason | String | 失败原因 |
示例
请求示例
POST https://imm.cn-shanghai.aliyuncs.com
?Action=DetectQRCodes
&Project=test
&SrcUris=["oss://bucket1/1.jpg"]
成功返回示例
{
"RequestId": "BC5CC880-6534-44EE-8397-F0703ECAAAAA",
"SuccessDetails": [
{
"SrcUri": "oss://bucket1/1.jpg",
"QRCodes": [
{
"QRCodesRectangle": {
"Top": 25,
"Height": 151,
"Width": 150,
"Left": 26
},
"Content": "http://aliyun.com/"
}
]
}
],
"FailDetails": []
}
失败返回示例
{
"RequestId": "A9C7B8D9-9C40-4ED0-BC42-B2DCA3DAAAAA",
"SuccessDetails": [],
"FailDetails": [
{
"ErrorMessage": "The resource SrcUris is not valid. Please check.",
"SrcUri": "oss://bucket1/2.jpg",
"ErrorCode": "InvalidSrcUris"
}
]
}
特殊错误码
错误代码 | 错误信息 | HTTP 状态码 | 说明 |
---|---|---|---|
InvalidSrcUris | The resource SrcUris is not valid. Please check. | 400 | 图片资源无效,文件格式错误或文件不存在 |
InvalidParameter.SrcUris.NotSupported | The input parameter SrcUris is not supported. Support valid OSS uri in same region. | 400 | SrcUri文件路径错误,需要使用正确的OSS格式的路径 |
版权声明
本文仅代表作者观点,不代表本站立场。
本文系作者授权发表,未经许可,不得转载。
评论