二维码生成/解码

POST 其他接口 QPS ≤ 15 并发 ≤ 20 运行中
https://api.fohok.xin/v1/qrsf

接口说明

生成二维码,png / svg,可调纠错级、边距、尺寸

请求参数

参数名 位置 类型 必填 示例
content body string 必填 https://example.com
二维码内容,v=1 时必填
v body string 可选 1
1=生成二维码(默认);2=解码二维码
format body string 可选 png
生成图片格式。仅支持png或svg
ecc body string 可选 M
容错级别,仅支持 L / M / Q / H
margin body string 可选 4
边距,范围 0-64 之间的整数
size body string 可选 512
图片尺寸,仅 format=png 有效,范围 64-4096 之间的整数
image body string 可选 文件对象
上传图片进行解码,v=2 时有效,multipart 字段,不超过 2MB
url body string 可选 https://example.com/qr.png
图片URL进行解码,v=2 时有效
base64 body string 可选 Base64图片数据进行解码,v=2 时有效
data:image/png;base64,iVBORw0KGgo...

请求示例

curl
curl -X POST 'https://api.fohok.xin/v1/qrsf' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"content":"https://example.com","v":"1","format":"png","ecc":"M","margin":"4","size":"512","image":"文件对象","url":"https://example.com/qr.png","base64":"Base64图片数据进行解码,v=2 时有效"}'

响应说明

字段类型说明
code integer 状态码,0 表示成功
message string 状态信息,成功时为 ok
data object 业务数据
content string 解析出的二维码内容
format string 文件格式
image string 生成结果的 Base64 或 Data URI
size integer 图片尺寸宽度/高度
margin integer 边距大小
ecc string 容错级别
width integer 解析出的图片宽度
height integer 解析出的图片高度
meth string 解码方式
updated string 响应更新时间
copyright string 版权信息

响应头附带 X-Request-Id、X-Response-Time、X-Billing-Mode、X-Billing-Tier、X-Token-Cost,便于对账与性能观测。

计费与价梯

计费模式按次扣费per_call 计量单位次 统计周期按月
价梯累计区间单价(Token)说明
第 1 档 0 – 600 次 9.9000 / 次 起步价
第 2 档 600 – 1,200 次 5.4000 / 次 累计用量进入本档后按此价
第 3 档 1,200 – 1,800 次 3.2000 / 次 累计用量进入本档后按此价
第 4 档 1,800 以上 次 1.2000 / 次 最高档,超出仍按此价

累计量按「当前 Key × 该接口」单独统计:你换一个 Key、或调另一个接口,都从各自的累计量算起,互不影响;用量越大单价越低。 每次调用都会在响应头返回 X-Billing-Tier,标明本次消耗归属的价梯档位。

错误码

HTTPerror说明
400bad_request请求参数不合法
401missing_api_key / invalid_api_key缺少或无效的 API Key
402insufficient_balanceToken 余额不足
403api_key_disabled / ip_not_allowedKey 被禁用或 IP 不在白名单
429rate_limited / daily_limit_exceeded触发限流或当日额度用尽
503server_busy / queue_timeout并发超限排队超时
502upstream_error上游服务异常
闽ICP备2026024151号 闽公网安备35058302351237号