Advanced QR Code Generator API

QR code generator, creator, and barcode API. Generate configurable QR codes with logos, colors, error correction. PNG, SVG, or WEBP output. Scan verification, quality score. Deterministic, production-ready.

原始信息汇总

Advanced QR Code Generator API 数据集概述

基本信息

• API名称: Advanced QR Code Generator API
• 版本: v1 (current)
• 主要端点: POST /generate
• 基础订阅价格: $0.00 / 月

功能描述

该API用于生成高度可配置、生产就绪的QR码，并内置扫描可靠性分析。它支持高级定制，如徽标、颜色、纠错级别和输出格式，同时验证最终QR码的可扫描性和质量。

核心功能

• 生成QR码: 从文本或URL生成QR码，可配置尺寸和纠错级别。
• 嵌入徽标: 在中心嵌入徽标（仅PNG/WEBP），支持自动缩放和内边距。
• 自定义外观: 自定义前景色和背景色。
• 质量验证: 通过扫描可靠性验证和对比度分析确保质量。
• 多格式支持: 支持PNG（默认）、SVG和WEBP输出格式。
• 提供警告: 针对可能影响扫描可靠性的非致命问题提供警告。
• 无状态与确定性: 不存储数据；最大有效负载为5MB；相同输入始终产生相同输出。

关键特性

• 纠错级别: L, M, Q, H（最大数据长度随级别变化）。
• 徽标支持: Base64编码的PNG/JPG/GIF/WEBP图像；缩放比例0.1–0.3。
• 尺寸范围: 64–4096 像素；静区0–10个模块。
• 质量指标: 提供 scanVerified（扫描验证）、qualityScore（质量分数）、warnings（警告）字段。

使用场景

• URL编码: 链接、深度链接、UTM跟踪。
• 品牌QR码: 自定义颜色和徽标。
• 生产用途: 可靠、经过验证的输出。
• 多格式需求: Web使用PNG，印刷使用SVG，现代技术栈使用WEBP。

请求参数

参数	类型	必需	默认值	描述
data	string	是	-	要编码到QR码中的文本或URL（最大长度因ECC级别而异）
size	number	否	512	QR码像素尺寸（64-4096）
errorCorrectionLevel	string	否	"M"	纠错级别："L"、"M"、"Q" 或 "H"
foregroundColor	string	否	"#000000"	前景色（十六进制格式，如 "#000000"）
backgroundColor	string	否	"#ffffff"	背景色（十六进制格式，如 "#ffffff"）
quietZone	number	否	4	静区（边框）大小，以模块为单位（0-10）
format	string	否	"png"	输出格式："png"、"svg" 或 "webp"
logo	object	否	-	徽标配置（见下表）

徽标配置参数

参数	类型	必需	默认值	描述
base64	string	是	-	Base64编码的图像数据（PNG、JPG、GIF或WEBP）
scale	number	否	0.2	徽标缩放比例（0.1-0.3），相对于QR码尺寸的比例
padding	number	否	auto	徽标周围的填充像素（如果未指定则自动计算）

各纠错级别最大数据长度

纠错级别	最大数据长度
L	2,953 字符
M	2,331 字符
Q	1,663 字符
H	1,273 字符

响应字段

字段	类型	描述
imageBase64	string	Base64编码的QR码图像
format	string	使用的输出格式（png、svg 或 webp）
size	number	实际的QR码像素尺寸
errorCorrectionLevel	string	使用的纠错级别
scanVerified	boolean	QR码是否被成功扫描和验证
qualityScore	number	基于多种因素的质量分数（0-100）
warnings	array	非致命问题的警告数组

错误代码

错误代码	HTTP状态码	描述
MISSING_DATA	400	缺少必需的 data 字段
INVALID_DATA	400	data 字段为空或无效
DATA_TOO_LARGE	400	数据长度超过所选纠错级别的最大值
INVALID_SIZE	400	尺寸不是数字、低于最小值（64）或超过最大值（4096）
INVALID_ERROR_CORRECTION_LEVEL	400	纠错级别不是 L, M, Q, H 之一
INVALID_LOGO_DATA	400	徽标base64数据缺失或无效
INVALID_LOGO_IMAGE	400	徽标数据无法解码为有效图像
UNSUPPORTED_LOGO_FORMAT	400	徽标格式不支持（仅支持 PNG, JPG, GIF, WEBP）
LOGO_DIMENSIONS_TOO_LARGE	400	徽标尺寸超过最大值（1024x1024像素）
LOGO_TOO_LARGE	400	徽标缩放比例超过最大值（0.3）
LOGO_PADDING_EXCEEDED	400	徽标填充超过安全限制
INVALID_FOREGROUND_COLOR	400	前景色不是有效的十六进制颜色
INVALID_BACKGROUND_COLOR	400	背景色不是有效的十六进制颜色
INSUFFICIENT_CONTRAST	400	前景色和背景色相同或对比度低于最小值（4.5）
INVALID_QUIET_ZONE	400	静区不是数字、低于最小值（0）或超过最大值（10）
UNSUPPORTED_FORMAT	400	输出格式不是 png, svg, webp 之一
INVALID_FORMAT_OPTION	400	请求了SVG格式但提供了徽标（徽标仅支持PNG/WEBP）
QR_DECODE_FAILED	422	生成的QR码解码验证失败
QR_RENDER_FAILED	500	QR码内部渲染失败
PAYLOAD_TOO_LARGE	413	请求负载超过最大大小（5MB）

警告代码

警告代码	描述
LOW_CONTRAST	前景和背景对比度低于最佳水平（7.0）但高于最低要求（4.5）
EXCESSIVE_LOGO_COVERAGE	徽标覆盖率超过推荐最大值（30%）
LOGO_TOO_LARGE	徽标超过所选纠错级别的安全覆盖百分比
LOGO_ECC_MISMATCH	提供了徽标但纠错级别较低（L或M）；建议使用Q或H
SMALL_SIZE	QR码尺寸低于可靠扫描的推荐最小值（256像素）
HIGH_ERROR_CORRECTION_RECOMMENDED	使用自定义颜色但纠错级别较低；建议使用Q或H
INSUFFICIENT_QUIET_ZONE	静区低于推荐最小值（4个模块）
LOW_SCAN_RELIABILITY	扫描可靠性低于阈值

搜集汇总

背景与挑战

背景概述

该数据集是一个高级QR码生成器API，能够创建可配置的QR码，支持添加Logo、自定义颜色和纠错功能，输出格式包括PNG、SVG或WEBP，并提供扫描验证与质量评分，确保确定性和生产就绪。