生成二维码

使用示例 1. 直接浏览器访问生成二维码（raw=1模式） 直接在浏览器地址栏输入以下链接即可显示二维码图片： ``` https://api.xunjinlu.fun/api/qrcode/createqrcode.php?data=https://www.example.com&raw=1 ``` 带参数的完整示例： ``` https://api.xunjinlu.fun/api/qrcode/createqrcode.php?data=Hello%20World&size=400x400&format=png&error_correction=H&border=4&raw=1 ``` 2. GET请求获取JSON数据 ```bash curl "https://api.xunjinlu.fun/api/qrcode/createqrcode.php?data=https://example.com&size=300x300&format=png" ``` 3. POST请求（JSON格式） ```bash curl -X POST https://api.xunjinlu.fun/api/qrcode/createqrcode.php \ -H "Content-Type: application/json" \ -d '{ "data": "Hello World", "size": "400x400", "format": "png", "error_correction": "H", "border": 4 }' ``` 4. 直接获取图片并保存（raw=1） ```bash curl "https://api.xunjinlu.fun/api/qrcode/createqrcode.php?data=Test&raw=1" --output qrcode.png ``` 5. 触发下载（download=1） ```bash curl "https://api.xunjinlu.fun/api/qrcode/createqrcode.php?data=Test&download=1" -o qrcode.png ``` 6. HTML嵌入示例 方式1：使用Base64（JSON模式） ```html ``` 方式2：直接嵌入图片（raw=1模式，推荐） ```html ``` 方式3：Markdown中使用 ```markdown  ``` 参数说明 参数 类型 必填 默认值 说明 data string 是 - 二维码内容，支持URL、文本、邮箱、电话等 size string 否 256x256 尺寸格式：整数或"宽x高" format string 否 png png(位图)或svg(矢量图) error_correction string 否 M 纠错级别：L/M/Q/H border int 否 2 边框宽度，0表示无边框 raw int 否 0 1=直接返回图片流，0=返回JSON download int 否 0 1=触发下载，0=直接显示 logo string 否 - Logo图片URL，显示在二维码中心 错误码说明 状态码 说明 200 请求成功 400 参数错误（如data为空或格式错误） 500 服务器内部错误 502 上游API请求失败 直接访问生成二维码的URL构建规则 基础URL： ``` https://api.xunjinlu.fun/api/qrcode/createqrcode.php ``` 必须添加的参数： - `data` = 二维码内容（需URL编码） - `raw` = 1（必须设置为1才能直接显示图片） 可选参数： - `size` = 尺寸（如300x300） - `format` = 格式（png或svg） - `error_correction` = 纠错级别（L/M/Q/H） - `border` = 边框宽度（0-10） 完整示例URL： ``` https://api.xunjinlu.fun/api/qrcode/createqrcode.php?data=https%3A%2F%2Fwww.baidu.com&size=300x300&format=png&error_correction=M&border=2&raw=1 ``` 注意事项 1. data参数必须进行URL编码，特别是包含中文或特殊字符时 2. 纠错级别越高，二维码能存储的数据越少，但容错能力越强 3. SVG格式适合打印和高清展示，PNG适合网页直接显示 4. 建议对data内容做长度限制，超长内容可能导致生成失败 5. 使用raw=1模式时，浏览器会直接显示图片，适合标签引用 6. 使用download=1模式时，浏览器会触发下载对话框 7. 支持CORS跨域，可在任何网站直接调用 ```

# 生成二维码 API 文档 ## 接口简介 本API提供二维码生成功能。支持生成PNG位图或SVG矢量格式的二维码，可自定义尺寸、纠错级别、边框宽度等参数。适用于需要集成二维码生成功能的Web应用、移动应用或第三方系统。 ## 请求说明 - **完整接口地址**：[https://api.xunjinlu.fun/api/qrcode/createqrcode.php](https://api.xunjinlu.fun/api/qrcode/createqrcode.php) - **接口路径**：/api/qrcode/createqrcode.php - **请求方法**：GET, POST - **请求头**：无特殊要求，可以使用通用HTTP请求头。 ## 请求参数 | 参数名 | 类型 | 是否必填 | 说明 | |-----------|--------|----------|------------------------------------------------------------| | data | string | 是 | 二维码中包含的文本内容（URL、文本、联系方式等），必填，建议不超过900个字符 | | size | string | 否 | 二维码尺寸，格式为'256'或'256x256'，默认256x256像素 | | format | string | 否 | 输出格式，可选值：png（位图，默认）、svg（矢量图） | | error_correction | string | 否 | 纠错级别，可选值：L(7%)、M(15%，默认)、Q(25%)、H(30%) | | border | integer | 否 | 边框宽度（以码点为单位），默认2，最小0 | | raw | integer | 否 | 直接输出图片模式，1=直接输出图片流到浏览器，0或不传=返回JSON（默认） | | download | integer | 否 | 下载模式，1=触发浏览器下载图片，0或不传=不下载（默认）。优先级低于raw | | logo | string | 否 | Logo图片URL，会在二维码中心显示该图片 | ## 返回参数 | 参数名 | 类型 | 说明 | |---------------|----------|------------------------------------------------------------| | code | integer | 状态码，200表示成功，其他错误码表示失败 | | data | object | 返回的数据对象，包含二维码的图像信息等 | | message | string | 状态信息，用于描述操作结果 | | image_base64 | string | 二维码的Base64编码，可用于直接在网页上显示或嵌入到图片标签中 | | image_url | string | 二维码图片的URL，可以直接访问图片文件 | | api_url | string | 生成二维码的API请求URL，可用于直接访问API接口生成二维码图片 | | format | string | 生成的二维码格式，如png或svg | | size | string | 生成的二维码尺寸，如256x256 | | data_content | string | 二维码中包含的文本内容 | | error_correction | string | 二维码的纠错级别 | | border | integer | 二维码的边框宽度 | | direct_image_url | string | 直接输出图片的URL，用于直接显示或下载图片 | ## 返回示例 ### 成功响应（默认Base64模式） ```json { "code": 200, "data": { "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA...", "image_url": "https://api.2dcode.biz/v1/create-qr-code?data=Example&size=256x256&format=png&error_correction=M&border=2", "api_url": "https://api.xunjinlu.fun/api/qrcode/createqrcode.php", "format": "png", "size": "256x256", "data_content": "Example", "error_correction": "M", "border": 2, "direct_image_url": "https://api.xunjinlu.fun/api/qrcode/createqrcode.php?data=Example&raw=1&size=256x256&format=png" }, "message": "success" } ``` ### 错误响应示例 ```json { "code": 400, "data": null, "message": "参数验证失败: data参数不能为空" } ``` ```json { "code": 502, "data": null, "message": "二维码生成失败: HTTP Error: 503" } ``` ## 错误码说明 - 400：参数验证失败，请检查请求参数是否正确。 - 502：二维码生成失败，请稍后重试或联系技术支持。 ## 调用示例 ### 直接访问链接 [https://api.xunjinlu.fun/api/qrcode/createqrcode.php?data=Example&size=256x256&format=png&error_correction=M&border=2](https://api.xunjinlu.fun/api/qrcode/createqrcode.php?data=Example&size=256x256&format=png&error_correction=M&border=2) ### cURL命令示例 ```bash curl -X POST "https://api.xunjinlu.fun/api/qrcode/createqrcode.php" -H "Content-Type: application/json" -d '{"data":"Example","size":"256x256","format":"png","error_correction":"M","border":"2"}' ``` ### JavaScript (fetch) 示例 ```javascript fetch('https://api.xunjinlu.fun/api/qrcode/createqrcode.php', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ data: 'Example', size: '256x256', format: 'png', error_correction: 'M', border: '2' }) }).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/createqrcode.php', type: 'POST', contentType: 'application/json', data: JSON.stringify({ data: 'Example', size: '256x256', format: 'png', error_correction: 'M', border: '2' }), 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/createqrcode.php' data = { 'data': 'Example', 'size': '256x256', 'format': 'png', 'error_correction': 'M', 'border': '2' } response = requests.post(url, json=data) print(response.json()) ``` ### PHP (curl) 示例 ```php 'Example', 'size' => '256x256', 'format' => 'png', 'error_correction' => 'M', 'border' => '2' ); $ch = curl_init($url); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_POST, true); curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data)); curl_setopt($ch, CURLOPT_HTTPHEADER, array( 'Content-Type: application/json' )); $response = curl_exec($ch); curl_close($ch); echo $response; ?> ``` ### HTML (iframe/img/script标签) ```html ```