二维码 / 一维码生成器

支持生成二维码（QR Code）和多种格式的一维码（条形码），可输出 PNG、SVG 或 base64 JSON。

二维码生成

• 方法: GET
• 路径: /api/web/tools/qrcode
• 返回类型: 图片（image/png 或 image/svg+xml）或 JSON（format=json 时）

请求参数 (Query)

参数	类型	必填	默认值	说明
text	string	是	—	二维码内容（URL、文本等）
size	number	否	300	图片宽度（像素）
margin	number	否	2	边距（模块数）
dark	string	否	#000000	深色模块颜色（hex）
light	string	否	#ffffff	浅色模块颜色（hex）
format	string	否	png	输出格式：png / svg / json

请求示例

# 直接返回 PNG 图片（可在 <img src="..."> 中直接使用）
GET /api/web/tools/qrcode?text=https://lolku.cn&size=300

# 返回 SVG 矢量图
GET /api/web/tools/qrcode?text=https://lolku.cn&format=svg

# 返回 base64 JSON
GET /api/web/tools/qrcode?text=https://lolku.cn&format=json

JSON 响应示例（format=json）

{
  "code": 200,
  "data": {
    "text": "https://lolku.cn",
    "format": "png",
    "size": 300,
    "base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAASwAAAEs..."
  },
  "message": "success"
}

使用方式

<!-- 直接作为图片源 -->
<img src="/api/web/tools/qrcode?text=https://lolku.cn&size=200" alt="QR Code" />

GET在线测试

text *

size

margin

dark

light

format

一维码/条形码生成

• 方法: GET
• 路径: /api/web/tools/barcode
• 返回类型: 图片（image/png 或 image/svg+xml）或 JSON（format=json 时）

支持的条码类型

代码	名称	说明
code128	Code 128	通用条码（默认），支持 ASCII 字符
code39	Code 39	工业用，支持数字+大写字母+特殊符号
code93	Code 93	Code 39 的增强版
ean13	EAN-13	商品条码（13位数字）
ean8	EAN-8	商品条码（8位数字）
upca	UPC-A	北美商品条码（12位数字）
upce	UPC-E	UPC-A 压缩版
codabar	Codabar	图书馆、医疗用
itf	ITF	交叉 25 码（物流用）
msi	MSI	仓库管理用

请求参数 (Query)

参数	类型	必填	默认值	说明
text	string	是	—	条码内容
type	string	否	code128	条码类型（见上表）
scale	number	否	2	缩放比例
height	number	否	50	条码高度（像素）
textlabel	boolean	否	true	是否在条码下方显示文字（false 隐藏）
format	string	否	png	输出格式：png / svg / json

请求示例

# Code128 条码
GET /api/web/tools/barcode?text=123456789&type=code128

# EAN-13 商品条码
GET /api/web/tools/barcode?text=6901234567892&type=ean13

# 不显示文字
GET /api/web/tools/barcode?text=HELLO123&type=code39&textlabel=false

JSON 响应示例（format=json）

{
  "code": 200,
  "data": {
    "text": "123456789",
    "type": "code128",
    "format": "png",
    "base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
  },
  "message": "success"
}

条码内容限制

不同条码类型对内容有不同限制：EAN-13 需要 12-13 位数字、UPC-A 需要 11-12 位数字、Code 39 只支持数字和大写字母。请根据类型输入合法内容。

GET在线测试

text *

type

scale

height

textlabel falsetrue

format