API 接口文档（正在测试中）

详细介绍如何调用 QR Code API 生成二维码 — 支持 GET 请求，返回 PNG / SVG 格式

快速上手接口地址请求参数调用方式进阶用法响应码

▶ 快速上手

获取密钥

发送邮件至 [email protected]，注明用途，审核通过后获取 API 密钥。

构造请求

拼接 URL 参数：data（必填）+ key（密钥），发送 GET 请求。

获取二维码

接口直接返回图片（PNG 或 SVG），可在浏览器预览或通过代码集成。

⚙ 接口地址

// 基础调用 — 将 YOUR_API_KEY 替换为你的密钥
https://qr.777778888.xyz/api/qr?data=hello%20world&key=YOUR_API_KEY

ℹ 接口采用 HTTP GET 方式调用，返回二维码图片（PNG 位图或 SVG 矢量图）。

cURL 调用

curl "https://qr.777778888.xyz/api/qr?data=hello%20world&key=YOUR_API_KEY" -o qrcode.png

☰ 请求参数说明

参数	必填	说明	默认值
`data`	是	二维码内容（URL、文本、数字等），需 URL 编码	-
`key`	否*	API 密钥（直接访问或脚本调用时必填）	-
`size`	否	图片尺寸（像素），范围 100-1000	`200`
`format`	否	输出格式：`png`（位图）/ `svg`（矢量）	`png`
`color`	否	前景色（十六进制，不含 #），如 `1a73e8`	`000000`
`bgcolor`	否	背景色（十六进制，不含 #），如 `f5f5f5`	`ffffff`
`logo`	否	中心图标（URL 或 Data URL）	-

ℹ 纠错级别：所有二维码统一使用 Q 级（较高 25%）纠错，在容量与容错之间取得良好平衡。

ℹ 鉴权方式：key 可通过 URL 参数 ?key= 或请求头 x-api-key 传递。若请求来自已授权的域名（携带 Referer 头），则无需提供密钥。

🔗 调用方式 — 三种集成方案

方式一：HTML 图片标签

将二维码图片直接嵌入网页，适合静态展示

方式二：Fetch API（推荐）

fetch(url, { headers: { 'x-api-key': 'YOUR_API_KEY' } })

通过 JavaScript 动态获取二维码图片数据，适合前端应用

方式三：直接浏览器打开

https://qr.777778888.xyz/api/qr?data=hello%20world&size=200&key=YOUR_API_KEY

在浏览器地址栏直接访问即可看到二维码，适合快速测试

🎨 进阶参数用法

自定义颜色

/api/qr?data=hello&color=1a73e8&bgcolor=f5f5f5

蓝色前景 + 浅灰背景

SVG 矢量输出

/api/qr?data=hello&format=svg

适合需要无损缩放的场景

大尺寸高清

/api/qr?data=hello&size=600

适合打印或大屏展示

SVG + 中心图标

/api/qr?data=hello&format=svg&logo=https://example.com/icon.png

中心嵌入自定义图标

⚠ 响应状态码说明

200

成功
正常返回二维码图片（PNG 或 SVG）

400

参数错误
data 参数缺失或格式不正确

401

密钥无效
key 参数缺失或密钥不正确

403

域名未授权
请求来源域名不在白名单中

404

接口不存在
请求路径错误，确认使用 /api/qr

429

请求过频
超出频率限制，请稍后重试

500

服务端错误
服务器内部错误，请联系管理员

✓纯本地生成，不依赖外部服务

✓不上传、不记录、不存储任何数据

✓不使用 Cookie 或追踪器

✓基于 qrcodejs 开源库（MIT 协议）

✓支持 API 集成与在线制作双模式

✓仅限合法用途