通用二维码解析读取

上传二维码图片，读取文本与图像内坐标
仅支持 REST/Postman 文件上传，不提供 MCP 文件读取工具。每次读取一个有效码，返回码制、文本、类型及四角坐标；不会执行解码内容或访问其中链接。Parsed 与 Raw 沿用解码文本，不承诺转换为协议对象。
上传二维码图片并读取其中内容。
返回解码文本，便于人工核验。
保留原始文本字段，方便资料对应。
返回识别到的码制名称。
返回既有解码类型标记，便于结果整理。
返回图像内四角坐标，便于标记识别位置。
可用于核对链接二维码中的地址文本。
可用于数字或业务编号的图片资料整理。
可为内容录入前的审阅流程提供文本资料。
可将图片与解码结果关联保存到自有资料系统。
适用于后台上传图片后的内容核对。
提供公开样例图片和对应结果，便于验证接入。

当前接口契约

接口详情：https://www.gugudata.com/api/details/qrcode-decode

请求参数

参数	类型	必填	默认值	说明
appkey	string	否	无	调用凭据；兼容现有有效位置，多处须一致。此鉴权位置可选；整体鉴权要求及其他已支持位置以本操作说明为准。
file	string/binary	是	无	单个图片上传；正式字段 file，兼容历史单文件字段名。

正常响应字段

字段	类型	说明
DataStatus.RequestParameter	string	真实、可读的业务请求参数；无业务参数时为空，不包含凭据。
DataStatus.StatusCode	integer	接口返回状态码
DataStatus.StatusDescription	string	接口返回状态说明
DataStatus.ResponseDateTime	string	接口数据返回时间
DataStatus.DataTotalCount	integer	成功结果对象数量，为 1。
Data	object	仅支持 REST/Postman 文件上传，不提供 MCP 文件读取工具。每次读取一个有效码，返回码制、文本、类型及四角坐标；不会执行解码内容或访问其中链接。Parsed 与 Raw 沿用解码文本，不承诺转换为协议对象。
Data.Format	string	二维码的格式
Data.Parsed	string	解析后的内容
Data.Points	array	二维码在图像中的坐标点
Data.Raw	string	原始内容
Data.Type	string	内容的类型

业务状态说明

业务状态码	业务状态码解释	备注
100	成功	HTTP 200
501	参数或文件错误	HTTP 400
901	依赖失败或超时	HTTP 503
502	请求频率限制	HTTP 429
503	权益已过期	HTTP 403
504	凭据无效或无接口权限	HTTP 401
505	调用额度不足	HTTP 403

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

成功（业务码 100）。

Bodyapplication/json

示例

{
  "DataStatus": {
    "RequestParameter": "file=qrcode-demo-image.png",
    "StatusCode": 100,
    "StatusDescription": "解码成功",
    "ResponseDateTime": "2026-10-15 19:40:35.031",
    "DataTotalCount": 1
  },
  "Data": {
    "Format": "QR_CODE",
    "Parsed": "https://www.gugudata.com/",
    "Points": [
      [
        16,
        16
      ],
      [
        132,
        16
      ],
      [
        132,
        132
      ],
      [
        16,
        132
      ]
    ],
    "Raw": "https://www.gugudata.com/",
    "Type": "TEXT"
  }
}

🟠400参数或文件错误（业务码 501）。

🔴503依赖失败或超时（业务码 901）。

🟠429请求频率限制（业务码 502）。

🟠403权益已过期（业务码 503）；调用额度不足（业务码 505）。

🟠401凭据无效或无接口权限（业务码 504）。

当前接口契约#

请求参数#

正常响应字段#

业务状态说明#

请求参数

请求示例代码

返回响应

当前接口契约

请求参数

正常响应字段

业务状态说明