API 文档
接口地址: https://api.gugudata.com/barcode/qrcode/decode?appkey=YOUR_APPKEY
返回格式: application/json; charset=utf-8
请求方式: POST
请求协议: HTTPS
请求示例: https://api.gugudata.com/barcode/qrcode/decode?appkey=YOUR_APPKEY
数据预览: https://www.gugudata.com/preview/qrcode-decode
接口测试: https://api.gugudata.com/barcode/qrcode/decode/demo
OpenAPI: https://www.gugudata.com/openapi/gugudata.openapi.3.1.json
请求参数(POST 请求参数以 application/x-www-form-urlencoded 格式、文件流以 formdata 格式传递,具体可参见下方示例代码)
| 参数名 |
参数类型 |
是否必须 |
默认值 |
备注 |
| 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 |
内容的类型 |
仅展示部分示例数据,数组最多展示 3 项,长内容已省略;完整数据请调用接口获取。
{
"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
]
],
"Raw": "https://www.gugudata.com/",
"Type": "TEXT"
}
}