图像

生成二维码

0次调用
免费接口

无论是网址、文本还是联系方式,通通可以变成一个二维码!这是一个非常灵活的二维码生成工具。

功能概述

你提供一段文本内容,我们为你生成对应的二维码图片。你可以自定义尺寸、前景色、背景色,还支持透明背景,并选择不同的返回格式以适应不同场景。

查询参数

text
string必填

你希望编码到二维码中的任何文本内容,比如一个URL、一段话或者一个JSON字符串。

size
integer可选

二维码图片的边长(正方形),单位是像素。有效范围是 256 到 2048 之间。

format
string可选

指定响应内容的格式。可选值为 image, json, json_url

transparent
boolean可选

是否使用透明背景。启用后生成的 PNG 图片将具有 alpha 通道,背景透明。

fgcolor
string可选

二维码前景色(即二维码本身的颜色),使用十六进制格式。URL 中需要将 # 编码为 %23

bgcolor
string可选

二维码背景色,使用十六进制格式。当 transparent=true 时此参数会被忽略。URL 中需要将 # 编码为 %23

响应

200 / 请求成功

请求成功。响应的格式和内容取决于你传入的 format 参数。请参考下面不同格式的定义。

格式 1image/png
图片响应说明
Response · Image/PNG
这是什么

接口返回的是图片的二进制数据流,而非 JSON 对象。客户端在接收到响应后,需要将其作为图片文件进行解析和处理。

前端展示方案

在浏览器环境中,最标准的做法是将响应体读取为 Blob 对象,并通过 URL.createObjectURL 生成一个临时的本地访问地址,最后将其赋值给 <img> 标签。为了避免内存泄漏,建议在图片加载完成后释放该 URL。

TYPESCRIPT
Node.js 服务端保存方案

如果是在 Node.js 环境中调用该接口,可以将响应转换为 ArrayBuffer,再转为 Buffer 并写入本地文件系统。

TYPESCRIPT
格式 2application/json
JSON

400 / 错误的请求

请求参数错误。请检查 text 是否提供,size 是否在有效范围内,format 是否为支持的值。

JSON

500 / 服务器内部错误

服务器内部错误。在生成二维码的过程中发生了未知错误。

JSON