星河API星河 API 观测平台

二维码生成

GET 公开 · 免密钥 版本 v1

生成二维码。支持 PNG / SVG / Base64 三种输出格式，可配置边长、静区宽度与纠错级别，纯本地生成、不依赖上游服务。

调用地址

https://api.shurans.cn/api/v1/qrcode

调用方式

GET

请求参数

参数必填示例说明
text 必填 https://example.com 二维码内容（网址、文本等，≤1000 字）
format 可选 svg 输出格式：png 二进制图片（默认）| svg 矢量图 | base64 返回 JSON（PNG 的 Base64 编码）
size 可选 300 边长（像素），50–1000，默认 200；SVG 精确生效，PNG 按模块整数倍缩放取整（近似值）
margin 可选 1 静区宽度（四周留白，单位模块数），0–50，默认 1
error_correction 可选 H 纠错级别：L（约 7%）| M（约 15%，默认）| Q（约 25%）| H（约 30%），级别越高可修复的破损越多、可容纳的数据越少

响应示例

{
    "code": 200,
    "message": "ok",
    "data": {
        "format": "base64",
        "mime": "image/png",
        "size": 200,
        "data": "iVBORw0KGgoAAAANSUhEUgAAAMQAAADEAQAAAADz07bVAAAA…（PNG 图片的 Base64 编码，此处截断）"
    },
    "meta": { "request_id": "7214361835712ec46e74081384fc82be" }
}

响应字段说明

字段说明
code 业务状态码，成功恒为 200
message 状态说明，成功恒为 ok
data.format 输出格式，恒为 base64（png / svg 为二进制直出，无 JSON 载荷）
data.mime 图片 MIME 类型，恒为 image/png
data.size 请求的边长（像素）
data.data PNG 图片的 Base64 编码，可直接用于 data URI：data:image/png;base64,<data>
meta.request_id 本次请求的追踪 ID（32 位十六进制），同时随 X-Request-Id 响应头返回

© 2026 星河 API