二维码解析

使用示例 1. GET方式 - 通过URL识别二维码 ```bash curl "https://api.xunjinlu.fun/api/qrcode/readqrcode.php?file_url=https%3A%2F%2Fgstatic.clewm.net%2Fcaoliao-resource%2F250408%2F80bc7c_bd33d499.png" ``` 浏览器直接访问： ``` https://api.xunjinlu.fun/api/qrcode/readqrcode.php?file_url=https://example.com/qrcode.png ``` 2. POST方式 - 上传本地文件识别 ```bash curl -X POST https://api.xunjinlu.fun/api/qrcode/readqrcode.php \ -F "file=@/path/to/qrcode.png" ``` 3. POST方式 - JSON格式通过URL识别 ```bash curl -X POST https://api.xunjinlu.fun/api/qrcode/readqrcode.php \ -H "Content-Type: application/json" \ -d '{ "file_url": "https://gstatic.clewm.net/caoliao-resource/250408/80bc7c_bd33d499.png" }' ``` 4. POST方式 - Base64图片识别 ```bash curl -X POST https://api.xunjinlu.fun/api/qrcode/readqrcode.php \ -H "Content-Type: application/json" \ -d '{ "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..." }' ``` 纯Base64字符串（不带data URI scheme）： ```bash curl -X POST https://api.xunjinlu.fun/api/qrcode/readqrcode.php \ -H "Content-Type: application/json" \ -d '{ "image_base64": "iVBORw0KGgoAAAANSUhEUgAA..." }' ``` 5. HTML表单上传示例 ```html

识别二维码

``` 6. JavaScript前端调用示例 Fetch API - URL识别 ```javascript fetch('https://api.xunjinlu.fun/api/qrcode/readqrcode.php?file_url=' + encodeURIComponent('https://example.com/qrcode.png')) .then(res => res.json()) .then(data => { if (data.code === 200) { console.log('识别内容:', data.data.contents); } }); ``` Fetch API - 文件上传 ```javascript const fileInput = document.getElementById('fileInput'); const formData = new FormData(); formData.append('file', fileInput.files[0]); fetch('https://api.xunjinlu.fun/api/qrcode/readqrcode.php', { method: 'POST', body: formData }) .then(res => res.json()) .then(data => { if (data.code === 200) { console.log('识别内容:', data.data.contents); } }); ``` Fetch API - Base64识别 ```javascript // 将File转换为Base64 function fileToBase64(file) { return new Promise((resolve, reject) => { const reader = new FileReader(); reader.readAsDataURL(file); reader.onload = () => resolve(reader.result); reader.onerror = error => reject(error); }); } fileToBase64(fileInput.files[0]).then(base64 => { fetch('https://api.xunjinlu.fun/api/qrcode/readqrcode.php', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ image_base64: base64 }) }) .then(res => res.json()) .then(data => console.log(data)); }); ``` 7. PHP调用示例 通过URL识别 ```php ``` 上传文件识别 ```php new CURLFile('/path/to/qrcode.png')]); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); $response = curl_exec($ch); curl_close($ch); $result = json_decode($response, true); print_r($result['data']['contents']); ?> ``` 8. Python调用示例 ```python import requests # GET方式 - URL识别 url = "https://api.xunjinlu.fun/api/qrcode/readqrcode.php" params = {"file_url": "https://example.com/qrcode.png"} response = requests.get(url, params=params) print(response.json()["data"]["contents"]) # POST方式 - 文件上传 files = {'file': open('qrcode.png', 'rb')} response = requests.post(url, files=files) print(response.json()["data"]["contents"]) ``` 参数说明 参数 类型 必填 说明 file_url string 条件必填 图片URL（GET或POST JSON方式），需三选一 file file 条件必填 上传的文件（POST form-data方式），需三选一 image_base64 string 条件必填 Base64图片数据（POST JSON方式），需三选一 注意：三种参数方式必须选择一种且只能选一种，同时提供多个参数时优先级为：file > image_base64 > file_url 错误码说明 状态码 说明 200 请求成功（包括识别到内容和未识别到内容） 400 参数错误（缺少参数、文件类型不支持、文件过大等） 405 不支持的请求方法（仅支持GET/POST） 500 服务器内部错误 502 上游API请求失败（网络问题或草料API异常） 响应数据结构 字段 类型 说明 code int 状态码，200为成功 message string 提示信息 data object 数据对象 ├─ contents array 识别到的二维码内容数组，可能包含多个结果 ├─ count int 识别到的二维码数量 └─ raw_response object 草料API原始响应数据 支持的图片格式 格式 MIME类型 说明 PNG image/png 推荐格式 JPEG image/jpeg 常用格式 JPG image/jpg 常用格式 GIF image/gif 支持动图首帧 BMP image/bmp Windows位图 WebP image/webp 现代压缩格式 使用限制 1. 文件上传大小限制：最大5MB 2. 图片URL必须可公开访问（不能是内网或需要鉴权的链接） 3. 支持的二维码类型：QR Code标准格式 4. 单张图片可识别多个二维码，结果以数组形式返回 5. 建议上传清晰、无遮挡、对比度高的二维码图片以获得最佳识别效果 注意事项 1. file_url参数在GET请求中必须进行URL编码，特别是包含特殊字符时 2. Base64数据支持带data URI scheme（data:image/png;base64,）和不带前缀两种格式 3. 文件上传后会在服务器端临时保存，识别完成后自动删除，不会保留用户数据 4. 如果图片中包含多个二维码，contents数组会包含所有识别结果 5. 当图片中没有二维码时，code仍为200，但contents为空数组，count为0 6. 支持CORS跨域，可在任何网站直接调用 7. 建议使用HTTPS协议的图片URL，避免混合内容安全策略问题 ```

# 二维码解析API接口文档 ## 接口简介 本API提供二维码识别功能，支持通过图片URL、上传本地图片文件或Base64编码的图片数据进行二维码解码。适用于需要集成二维码扫描功能的Web应用、移动应用或第三方系统。 ## 请求说明 - **完整接口地址**：https://api.xunjinlu.fun/api/qrcode/decodeqrcode.php - **请求方法**：GET, POST - **请求头**：无特殊要求，根据实际需要设置Content-Type ## 请求参数 | 参数名 | 类型 | 是否必填 | 说明 | |--------------|--------|----------|--------------------------------------------------------------| | file_url | string | 选填 | 二维码图片的URL地址，需URL编码，与file、image_base64三选一 | | file | file | 选填 | 上传的本地图片文件，支持png/jpg/gif/bmp/webp，最大5MB | | image_base64 | string | 选填 | Base64编码的图片数据，支持data:image/png;base64,xxx格式或纯Base64字符串 | ## 返回参数 | 参数名 | 类型 | 说明 | |---------------|----------|--------------------------------------------------------------| | code | integer | 状态码，200表示成功，其他值表示错误 | | data | object | 返回数据对象 | | - contents | array | 识别到的二维码内容列表 | | - count | integer | 识别到的二维码数量 | | - raw_response | object | 原始响应数据 | | message | string | 返回信息 | ## 返回示例 ### 成功响应（识别到内容） ```json { "code": 200, "data": { "contents": [ "https://www.example.com", "Hello World" ], "count": 2, "raw_response": { "code": 0, "message": "ok", "data": { "contents": [ "https://www.example.com", "Hello World" ] } } }, "message": "识别成功" } ``` ### 成功响应（未识别到内容） ```json { "code": 200, "data": { "contents": [], "count": 0, "raw_response": { "code": 0, "message": "ok", "data": { "contents": [] } } }, "message": "未识别到二维码内容" } ``` ### 错误响应示例 ```json { "code": 400, "data": null, "message": "参数错误: file_url不能为空" } ``` ## 错误码说明 - 400：参数错误 - 400：不支持的文件类型 - 502：识别失败 ## 调用示例 ### 直接访问链接 ```url https://api.xunjinlu.fun/api/qrcode/decodeqrcode.php?file_url=https%3A%2F%2Fexample.com%2Fqrcode.png ``` ### cURL命令示例 ```bash curl -X GET "https://api.xunjinlu.fun/api/qrcode/decodeqrcode.php" -H "Content-Type: application/json" -d '{"file_url": "https://example.com/qrcode.png"}' ``` ### JavaScript (fetch) 示例 ```javascript fetch('https://api.xunjinlu.fun/api/qrcode/decodeqrcode.php', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ file_url: 'https://example.com/qrcode.png' }) }) .then(response => response.json()) .then(data => console.log(data)) .catch(error => console.error('Error:', error)); ``` ### jQuery AJAX 示例 ```javascript $.ajax({ url: 'https://api.xunjinlu.fun/api/qrcode/decodeqrcode.php', type: 'POST', contentType: 'application/json', data: JSON.stringify({ file_url: 'https://example.com/qrcode.png' }), success: function(data) { console.log(data); }, error: function(error) { console.error('Error:', error); } }); ``` ### Python (requests) 示例 ```python import requests url = 'https://api.xunjinlu.fun/api/qrcode/decodeqrcode.php' data = {'file_url': 'https://example.com/qrcode.png'} response = requests.post(url, json=data) print(response.json()) ``` ### PHP (curl) 示例 ```php $url = 'https://api.xunjinlu.fun/api/qrcode/decodeqrcode.php'; $data = array('file_url' => 'https://example.com/qrcode.png'); $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $url); curl_setopt($ch, CURLOPT_POST, true); curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data)); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); $response = curl_exec($ch); curl_close($ch); echo $response; ``` ### HTML (iframe/img/script标签) ```html ```