生成二维码

使用示例 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=直接显示 错误码说明 状态码 说明 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跨域，可在任何网站直接调用 ```

> **声明：本文档由 AI 根据平台配置自动生成；示例为片段。** ## 接口简介 本API提供二维码生成功能，支持生成PNG位图或SVG矢量格式的二维码。用户可以自定义尺寸、纠错级别、边框宽度等参数。API通过GET或POST方法调用，返回JSON格式的数据。适用于需要集成二维码生成功能的Web应用、移动应用或第三方系统。 ## 请求说明 - 方法：GET, POST - 常用请求头：Content-Type: application/x-www-form-urlencoded（POST请求时） - 调用地址：https://api.xunjinlu.fun/api/qrcode/createqrcode.php ## 请求参数表 | 参数名 | 类型 | 必填 | 默认值 | 说明 | |--------|------|------|--------|------| | data | string | 是 | - | 二维码中包含的文本内容，建议不超过900个字符 | | size | string | 否 | 256x256 | 二维码尺寸，格式为'256'或'256x256' | | format | string | 否 | png | 输出格式，可选值：png（位图）、svg（矢量图） | | error_correction | string | 否 | M | 纠错级别，可选值：L(7%)、M(15%)、Q(25%)、H(30%) | | border | integer | 否 | 2 | 边框宽度（以码点为单位），最小0 | | raw | integer | 否 | 0 | 直接输出图片模式，1=直接输出图片流到浏览器，0=返回JSON | | download | integer | 否 | 0 | 下载模式，1=触发浏览器下载图片，0=不下载。优先级低于raw | ## 返回字段表 | 字段名 | 类型 | 说明 | |--------|------|------| | code | integer | 状态码，200表示成功 | | data | object | 返回数据，包含二维码相关信息 | | message | string | 状态信息 | data对象中的字段： | 字段名 | 类型 | 说明 | |--------|------|------| | image_base64 | string | Base64编码的图片数据 | | image_url | string | 图片URL | | api_url | string | API调用地址 | | format | string | 图片格式 | | size | string | 图片尺寸 | | data_content | string | 二维码内容 | | error_correction | string | 纠错级别 | | border | integer | 边框宽度 | | direct_image_url | string | 直接获取图片的URL | ## 返回示例 成功响应： ```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参数不能为空" } ``` ## 错误码 | 错误码 | 说明 | |--------|------| | 200 | 请求成功 | | 400 | 参数验证失败 | | 502 | 二维码生成失败 | | 404 | API接口不存在 | | 500 | 服务器内部错误 | ## 调用示例 浏览器直接访问： ``` https://api.xunjinlu.fun/api/qrcode/createqrcode.php?data=HelloWorld&size=256x256&format=png ``` cURL： ```bash curl "https://api.xunjinlu.fun/api/qrcode/createqrcode.php?data=HelloWorld&size=256x256&format=png" ``` Python： ```python import requests url = "https://api.xunjinlu.fun/api/qrcode/createqrcode.php" params = { "data": "HelloWorld", "size": "256x256", "format": "png" } response = requests.get(url, params=params) print(response.json()) ``` PHP： ```php "HelloWorld", "size" => "256x256", "format" => "png" ); $options = array( "http" => array( "header" => "Content-type: application/x-www-form-urlencoded\r\n", "method" => "POST", "content" => http_build_query($data) ) ); $context = stream_context_create($options); $result = file_get_contents($url, false, $context); echo $result; ?> ``` HTML： ```html ```