二维码生成

goQR.me

图像与媒体可直接调用免费

在线调试上游文档

调用地址

GET https://api.blueworkshop.top/api/v1/qrcode

无需鉴权支持 CORS 每 IP 每分钟 30 次；结果缓存 3600 秒

在线调试

请求会发送到本站接口

当前请求：https://api.blueworkshop.top/api/v1/qrcode

请求参数

参数	类型	默认值	说明
`data`必填	string	-	要编码到二维码中的文本或链接。示例：`https://api.blueworkshop.top`
`size`	枚举：150 / 200 / 300 / 500	`200`	图片边长（像素）。示例：`200`

请求示例

cURL

curl "https://api.blueworkshop.top/api/v1/qrcode?data=https%3A%2F%2Fapi.blueworkshop.top&size=200"

JavaScript

const res = await fetch("https://api.blueworkshop.top/api/v1/qrcode?data=https%3A%2F%2Fapi.blueworkshop.top&size=200");
const data = await res.json();
console.log(data);

响应示例

（成功时直接返回 image/png 图片二进制，不是 JSON）

成功时返回 JSON 信封：ok 表示是否成功，data 为数据，meta.cached 表示是否命中本站缓存。图片类接口直接返回二进制图片。

错误响应

HTTP	错误码	说明
400	`missing_param` / `invalid_param`	缺少参数或参数格式不正确，响应会带上出错参数名。
404	`not_found`	接口不存在，或上游没有找到对应资源。
405	`method_not_allowed`	请求方法与接口要求不一致。
429	`rate_limited`	请求过于频繁，响应头 Retry-After 给出建议等待秒数。
502	`upstream_error` / `upstream_rate_limited`	上游服务异常或触发限流。
504	`timeout`	上游请求超时。

接口说明

通过免费的 goQR.me 接口生成二维码，返回 PNG 图片。把接口地址直接放进 img 标签即可使用。

生成的二维码默认缓存 1 小时，适合活动页、名片、支付链接与文档分享。请遵守上游服务条款，不要用于违法违规内容。