二维码生成 · 德材翌科技API

二维码生成 API

将 UTF-8 文本或网址编码为二维码图像，支持 PNG、SVG、颜色、尺寸及四档容错级别。由本地 PHP 生成，不会请求或访问文本中的网址。

调用地址

请求方式POST / JSON

身份认证Bearer API Key

所属分类开发工具

调用费用免费

包月要求不强制包月，有效包月免点

补充说明

POST JSON: {"text":"德材翌科技API","size":320,"format":"png","level":"M","foreground":"#102B4E","background":"#FFFFFF"}。长度最多512字节，返回 data.image_base64。当前版本不支持 Logo。

请求参数

参数	类型	必填	说明
text	字符串	是	UTF-8 文本或网址；不超过 512 字节
size	整数	否	图像像素尺寸，128–1024，默认 320
level	字符串	否	纠错级别 L/M/Q/H，默认 M
format	字符串	否	png 或 svg，默认 png
foreground	颜色	否	前景色，#RRGGBB，默认 #102B4E
background	颜色	否	背景色，#RRGGBB，默认 #FFFFFF

请求头必须携带 Authorization: Bearer API Key、Content-Type: application/json。当前版本暂不支持添加 Logo；后续验证安全图片叠加后再扩展。

调用示例

cURL

curl -X POST "https://api.dcykjgw.com/api/v1/endpoints/qrcode" \
  -H "Authorization: Bearer dcy_你的完整密钥" \
  -H "Content-Type: application/json" \
  -d '{"text":"https://api.dcykjgw.com","size":320,"format":"png","level":"M"}'

JavaScript

fetch('https://api.dcykjgw.com/api/v1/endpoints/qrcode', {
  method: 'POST',
  headers: {'Content-Type':'application/json','Authorization':'Bearer dcy_你的完整密钥'},
  body: JSON.stringify({text:'德材翌科技API',size:320,format:'png',level:'M'})
}).then(r=>r.json()).then(console.log);

成功响应

{
  "code": 0,
  "msg": "二维码生成成功",
  "platform": "qrcode",
  "data": {
    "format": "png",
    "mime": "image/png",
    "width": 320,
    "height": 320,
    "image_base64": "图片内容的 Base64 编码"
  }
}

将 image_base64 Base64 解码后即可保存为图片；当 format=svg 时 MIME 为 image/svg+xml。

返回参数说明

字段	格式	说明
`code`	数字	业务状态码，0 表示本次接口调用成功；非 0 时结合 msg 和 HTTP 状态码排查。
`msg`	字符串	本次请求结果说明，成功时描述处理结果，失败时给出可读错误原因。
`platform`	字符串	当前接口/平台标识，成功响应中用于区分具体接口来源。
`data`	对象	接口业务数据；具体字段含义见下方本接口字段说明。
`data.format`	字符串	生成的二维码格式，当前为 png 或 svg。
`data.mime`	字符串	图片 MIME 类型，例如 image/png 或 image/svg+xml。
`data.width`	数字	二维码输出宽度，单位像素。
`data.height`	数字	二维码输出高度，单位像素。
`data.image_base64`	字符串	二维码文件的 Base64 内容，解码后即可保存为图片文件。

无效参数 HTTP 422；无效密钥 401；无权限或包月未授权 403；点数不足 402；频率超限 429。

在线生成二维码

仅向当前 API 发送请求，API Key 不保存到浏览器存储空间。

响应结果（省略图片 Base64）

填写参数后点击“生成二维码”。