通用二维码生成

将文本或网址生成可下载的二维码图片

保持现有文本和网址编码规则。size 默认 500，非正数或超过 500 时归一化为 500；使用既有整数模块比例，最终图片边长取决于内容及模块数，不保证恰等于 size。1–40 无法生成有效模块时失败。cdn=CLOUDFLARE 大小写不敏感，其余值沿用默认存储。

参数	类型	必填	默认值	说明
appkey	string	是	无	已开通本商品的 APPKEY；也可使用现有 Header 或 Bearer 鉴权，不同时要求多个载体。
content	string	是	无	需要编码的完整文本或网址。
size	int	否	500	沿用模块尺寸比例；最终图片像素并非固定等于该值。
cdn	string	否	空字符串	CLOUDFLARE 使用对应存储，其他历史值使用默认存储。

请求示例（与默认值独立）：

{
  "content": "https://www.gugudata.com/",
  "size": 200,
  "cdn": ""
}

业务说明

将单段文本生成二维码图片，便于将文字内容放入业务标签。

将网址生成二维码，方便从海报或材料进入对应页面。

支持中文内容，扫码后可核对完整原文。

支持 Unicode 文本，适合含多种文字的内容编码。

保留原有网址识别及编码规则，便于延续已有接入。

返回输入内容，方便将二维码与业务记录对应。

提供尺寸参数，并按现有模块比例生成图片。

生成 PNG 图片，可用于文档、页面及海报排版。

返回图片下载链接，便于取回后保存或展示。

适合书签、活动材料和信息标签等场景使用二维码。

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

成功，业务码 100。

Bodyapplication/json

示例

{"DataStatus":{"RequestParameter":"{\"content\":\"http://www.baidu.com\",\"size\":200,\"cdn\":\"\"}","StatusCode":100,"StatusDescription":"生成成功","ResponseDateTime":"2026-10-30 15:03:02.290","DataTotalCount":1},"Data":{"Content":"http://www.baidu.com","Url":"https://static.gugudata.com/qrcode/qrcode_2f5d5b044e5d4a058b7c32c628a22042.png"}}

🟠400请求参数错误。请求参数缺失、格式错误或参数组合不合法。

🟠401鉴权失败。缺少 appkey 或 appkey 无效。

🟠403无权限访问。订单到期、权限不足或接口额度不可用。

🟠404资源不存在。请求路径不存在。

🟠405请求方法不允许。当前路径不支持该 HTTP 方法。

🟠415请求内容类型不支持。上传或请求体的内容类型不符合接口要求。

🟠429请求频率受限。默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。

🔴500服务内部错误。服务端处理异常，请稍后重试。

🔴502上游依赖错误。上游依赖服务不可用或返回异常。

🔴503处理、依赖失败或超时，业务码 901。

业务说明#

请求参数

请求示例代码

返回响应

业务说明