二维码解析

使用示例 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，避免混合内容安全策略问题 ```