POST公开旧版二维码生成识别GIF迁移vv1

二维码(旧版)

旧 QRcode 重建:本地生成二维码(PNG/JPEG/GIF,支持前景/背景色、方点/圆角/圆点、静区、中心 logo、多帧 GIF 动画)与本地识别二维码(PNG/JPEG/GIF,含反色)。

/api/QRcode
在线调试
频率限制按方案
每日额度按方案
所需权限无

接口说明

旧 QRcode 重建:本地生成二维码(PNG/JPEG/GIF,支持前景/背景色、方点/圆角/圆点、静区、中心 logo、多帧 GIF 动画)与本地识别二维码(PNG/JPEG/GIF,含反色)。

请求参数

请求体为 JSON;未在接口定义中列出的字段一般会被忽略,但个别 Provider 单独校验的接口仍可能拒绝未声明字段;已定义字段仍会做类型、长度与枚举校验。

字段类型说明
0string旧路径参数:method
1string旧路径参数:cache 方法的文件名/key
dotstringencode:模块样式 square(缺省)| rounded | dots(也可用 style)
urlstringdecode:二维码图片链接
filestringdecode:旧上传参数,新平台改传 base64/data URI 字符串
logostringencode:中心 logo(http(s) / data URI / base64:// / 裸 base64)
sizeunionencode:边长像素,缺省 500,限制 50-2000(按整数模块对齐)
typestring兼容旧参数;新平台图片结果统一附带 /v1/media URL
colorstringencode:前景色,缺省 #000000,支持 #rgb/#rrggbb/#rrggbbaa/rgb()
imagestringdecode:base64 的别名
levelstringencode:纠错级别 L/M/Q/H,缺省 M;带 logo 时至少 Q
stylestringdot 的别名
actionstring旧路径参数:/v1/gateway/legacy-qrcode/<action> 会注入
base64stringdecode:二维码图片 base64(可带 data URI 前缀)
formatstringencode:png(缺省)| jpeg | gif
framesunionencode:GIF 帧数,把 frames>1 视为开启动画,缺省 3,限制 2-8
marginunionencode:静区宽度(模块数),缺省 4,限制 0-16
methodstringencode(缺省)| decode | cache
bgcolorstringencode:背景色,缺省 #FFFFFF
contentstringencode:二维码内容,缺省 http://Oiapi.net/
animatedunionencode:format=gif 时输出多帧呼吸动画(真值开启)
logo_sizeunionencode:logo 占整图百分比,缺省 20,限制 10-30

返回参数

成功响应中 data 内的字段(不含信封的 code / message / meta)。未列出的字段可能随版本增加,请忽略未知字段。

请求示例

request.json
{
  "size": 300,
  "content": "https://oiapi.net"
}

返回示例

response.json
{
  "code": 1,
  "data": {
    "size": 296,
    "level": "M",
    "format": "png",
    "modules": 29,
    "version": 3,
    "modulePx": 8
  },
  "message": {
    "url": "https://…/v1/media/…",
    "base64": "<base64>",
    "contentType": "image/png"
  }
}

所有接口统一返回 { code, message, data, error_code?, details?, meta }。 成功 code = 1;失败 code 为唯一负数(如 -10001)并给出结构化 error_code, 错误码说明 →