[DEMO] 通用二维码解析读取

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

当前接口契约

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

公开 Demo 用于查看调用方式和响应结构，返回范围以示例参数为准。

正常响应

HTTP 200，application/json。

字段	类型	说明
DataStatus	object
DataStatus.RequestParameter	string	真实、可读的业务请求参数；无业务参数时为空，不包含凭据。
DataStatus.StatusCode	integer	接口返回状态码
DataStatus.StatusDescription	string	接口返回状态说明
DataStatus.ResponseDateTime	string	接口数据返回时间
DataStatus.DataTotalCount	integer	成功结果对象数量，为 1。
Data	object

业务状态说明

业务状态码	业务状态码解释	备注
501	参数或文件错误	HTTP 400
901	依赖失败或超时	HTTP 503

返回响应

🟢200成功

application/json

业务成功，状态码 100；合法无匹配结果依产品契约返回。

Bodyapplication/json

示例

{
  "DataStatus": {
    "StatusCode": 100,
    "RequestParameter": "file=https://static.gugudata.com/qrcode_d31cde32-b341-41d6-ad42-8ca03e7c2cb4.png",
    "StatusDescription": "解码成功",
    "ResponseDateTime": "2026-10-15 19:40:35.002",
    "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。

当前接口契约#

正常响应#

业务状态说明#

请求参数

请求示例代码

返回响应

当前接口契约

正常响应

业务状态说明