云岭API开放平台
首页 / API 文档 / 二维码生成

二维码生成

把文本或链接生成二维码图片,返回可直接使用的图片地址。上游失败自动降级到本地 SVG 点阵二维码。

¥0.001/次 需 API Key5 QPS最后更新 2026-11-23
接口信息

二维码生成 v1.0

把文本或链接生成二维码图片,返回可直接使用的图片地址。上游失败自动降级到本地 SVG 点阵二维码。

接口地址https://api.ynshw.com.cn/api.php?action=QrCode&text=https%3A%2F%2Fwww.ynshw.com.cn&size=300
请求方式GET,POST
返回格式JSON
QPS 限制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
请求参数

请求参数

参数名类型必填说明
textstring是要编码的内容(URL 或文本,建议 ≤ 500 字)
sizeint否图片尺寸 100~1000,默认 300
keystring是API Key,控制台获取
sign/ts/noncestring否签名三元组,启用后防重放(5 分钟有效)
返回参数

返回参数

参数名类型说明
codeint状态码,200 为成功
msgstring提示信息
urlstring二维码图片地址
sizeint尺寸
sourcestring生成来源

返回示例

{
    "code": 200,
    "msg": "success",
    "data": {
        "url": "https://api.qrserver.com/v1/create-qr-code/?size=300x300&data=...",
        "size": 300,
        "source": "upstream"
    }
}
在线测试

在线测试

需要 API Key请先 登录 并在控制台复制你的 Key,填入下方即可真实发起调用。
// 点击「发送请求」查看返回结果
示例代码

多语言示例

错误码

响应状态码

code说明
200成功
201参数错误
202鉴权失败(Key 无效/签名错误/已过期)
203次数或余额不足
204接口不存在
205接口停用
206请求方式不允许
207请求限流(超出 QPS)
208IP 不在白名单
209内部错误
210需实名认证