接口信息
二维码生成 v1.0
把文本或链接生成二维码图片,返回可直接使用的图片地址。上游失败自动降级到本地 SVG 点阵二维码。
接口地址
https://api.ynshw.com.cn/api.php?action=QrCode&text=https%3A%2F%2Fwww.ynshw.com.cn&size=300请求方式
GET,POST返回格式
JSONQPS 限制
5计费
1 积分/次鉴权说明在请求中携带
key 参数(或请求头 X-API-Key / Authorization: Bearer)。生产环境建议启用签名:将参数按名排序拼接为 secret&ts&nonce&k=v&... 后取 MD5,随 sign/ts/nonce 一起传入。请求示例
https://api.ynshw.com.cn/api.php?action=QrCode&text=https%3A%2F%2Fwww.ynshw.com.cn&size=300
请求参数
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
text | string | 是 | 要编码的内容(URL 或文本,建议 ≤ 500 字) |
size | int | 否 | 图片尺寸 100~1000,默认 300 |
key | string | 是 | API Key,控制台获取 |
sign/ts/nonce | string | 否 | 签名三元组,启用后防重放(5 分钟有效) |
返回参数
返回参数
| 参数名 | 类型 | 说明 |
|---|---|---|
code | int | 状态码,200 为成功 |
msg | string | 提示信息 |
url | string | 二维码图片地址 |
size | int | 尺寸 |
source | string | 生成来源 |
返回示例
{
"code": 200,
"msg": "success",
"data": {
"url": "https://api.qrserver.com/v1/create-qr-code/?size=300x300&data=...",
"size": 300,
"source": "upstream"
}
}
示例代码
多语言示例
错误码
响应状态码
| code | 说明 |
|---|---|
200 | 成功 |
201 | 参数错误 |
202 | 鉴权失败(Key 无效/签名错误/已过期) |
203 | 次数或余额不足 |
204 | 接口不存在 |
205 | 接口停用 |
206 | 请求方式不允许 |
207 | 请求限流(超出 QPS) |
208 | IP 不在白名单 |
209 | 内部错误 |
210 | 需实名认证 |