二维码解析

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

> **声明：本文档由 AI 根据平台配置自动生成；示例为片段。** ## 接口简介 本API提供二维码识别功能，支持三种识别方式：通过图片URL识别、上传本地图片文件识别、以及Base64编码的图片数据识别。可识别二维码中的文本内容、URL、联系方式等信息，并支持识别图中多个二维码。适用于需要集成二维码扫描功能的Web应用、移动应用或第三方系统。 ## 请求说明 - **方法**：POST - **请求头**：Content-Type 根据请求方式不同而变化（multipart/form-data、application/json 或 application/x-www-form-urlencoded） - **请求地址**：`https://api.xunjinlu.fun/api/qrcode/decodeqrcode.php` ## 请求参数表 | 参数名 | 类型 | 必填 | 说明 | |-------|------|------|------| | 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 | int | 状态码，200表示成功，400表示参数错误，502表示识别失败 | | data | object | 识别结果数据 | | data.contents | array | 识别到的二维码内容数组 | | data.count | int | 识别到的二维码数量 | | data.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": 400, "data": null, "message": "参数错误: file_url不能为空" } ``` ## 错误码 | 错误码 | 说明 | |-------|------| | 200 | 识别成功 | | 400 | 参数错误，如缺少必要参数、文件类型不支持等 | | 502 | 识别失败，如图片无法加载、网络错误等 | ## 调用示例 ### 浏览器直接访问 ``` https://api.xunjinlu.fun/api/qrcode/decodeqrcode.php?file_url=https://example.com/qrcode.png ``` ### cURL ```bash curl -X POST -F "file=@/path/to/qrcode.png" https://api.xunjinlu.fun/api/qrcode/decodeqrcode.php ``` ### Python ```python import requests url = "https://api.xunjinlu.fun/api/qrcode/decodeqrcode.php" files = {'file': open('qrcode.png', 'rb')} response = requests.post(url, files=files) print(response.json()) ``` ### PHP ```php new CURLFile('qrcode.png')); $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $url); curl_setopt($ch, CURLOPT_POST, 1); curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); $response = curl_exec($ch); curl_close($ch); echo $response; ?> ``` ### HTML ```html

解析二维码

```