› 推特 ›阿里云技术文档›正文

DetectQRCodes二维码检测_图片管理类操作_API手册_智能媒体管理

admin 阿里云技术文档 2020-02-11 219 0
阿里云服务器优惠

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 失败原因

示例

请求示例

  1. POST https://imm.cn-shanghai.aliyuncs.com
  2. ?Action=DetectQRCodes
  3. &Project=test
  4. &SrcUris=["oss://bucket1/1.jpg"]

成功返回示例

  1. {
  2.   "RequestId": "BC5CC880-6534-44EE-8397-F0703ECAAAAA",
  3.   "SuccessDetails": [
  4.     {
  5.       "SrcUri": "oss://bucket1/1.jpg",
  6.       "QRCodes": [
  7.         {
  8.           "QRCodesRectangle": {
  9.             "Top": 25,
  10.             "Height": 151,
  11.             "Width": 150,
  12.             "Left": 26
  13.           },
  14.           "Content": "http://aliyun.com/"
  15.         }
  16.       ]
  17.     }
  18.   ],
  19.   "FailDetails": []
  20. }

失败返回示例

  1. {
  2.   "RequestId": "A9C7B8D9-9C40-4ED0-BC42-B2DCA3DAAAAA",
  3.   "SuccessDetails": [],
  4.   "FailDetails": [
  5.     {
  6.       "ErrorMessage": "The resource SrcUris is not valid. Please check.",
  7.       "SrcUri": "oss://bucket1/2.jpg",
  8.       "ErrorCode": "InvalidSrcUris"
  9.     }
  10.   ]
  11. }

特殊错误码

错误代码 错误信息 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格式的路径
版权声明

本文仅代表作者观点，不代表本站立场。
本文系作者授权发表，未经许可，不得转载。

评论

-----