二维码生成/解码
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,便于对账与性能观测。
计费与价梯
| 价梯 | 累计区间 | 单价(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,标明本次消耗归属的价梯档位。
错误码
| HTTP | error | 说明 |
|---|---|---|
| 400 | bad_request | 请求参数不合法 |
| 401 | missing_api_key / invalid_api_key | 缺少或无效的 API Key |
| 402 | insufficient_balance | Token 余额不足 |
| 403 | api_key_disabled / ip_not_allowed | Key 被禁用或 IP 不在白名单 |
| 429 | rate_limited / daily_limit_exceeded | 触发限流或当日额度用尽 |
| 503 | server_busy / queue_timeout | 并发超限排队超时 |
| 502 | upstream_error | 上游服务异常 |