# 旧版二维码美化API

说明：旧版二维码美化API已停止维护，可使用新版标签制作API，包含多种场景二维码标签样式，设置更灵活。[前往新版二维码标签API](https://help/integration-and-connection/label-api/api-label "前往新版二维码标签API")

## 功能介绍

旧版二维码美化API可通过HTTP请求生成自定义风格的二维码。

- 参数可控：可指定二维码颜色、形状、背景、Logo等个性化元素
- 应用场景广：适用于营销推广、产品包装、名片设计等多种场合
- 快速生成：仅需调整URL上的二维码内容（text）和美化模板ID（mhid），即可获得风格各异的二维码

![展示自定义二维码美化样式与调用URL示例，说明如何通过API接口接入并生成带模板ID的美化二维码](https://blogcdnimg.clewm.net/2025/03/image-1742524224345_17425242251562.png)

[旧版二维码美化API入口](https://cli.im/api "**旧版二维码美化API**")

## 调用说明

1. 自定义美化模板： 在草料平台，调整好二维码美化样式，上传Logo、修改二维码颜色或添加文字等。
2. 获取美化模板ID：完成美化后，获取对应的美化模板ID和URL。
3. HTTP调用： 将生成的链接中 text、mhid 等参数替换为自己的需求，发送HTTP请求即可得到对应二维码图片。

### URL参数示例

- text（二维码内容）：可填入网址、文本、联系方式等任何你想用二维码承载的信息。
- mhid（美化模板ID）：每个美化模板都有一个独特的ID，选择不同的模板可以改变二维码的外观设计。模板库提供了多种风格，以满足不同的品牌需求。

```html
https://api.cl2wm.cn/api/qrcode/code?text=二维码内容&mhid=美化模板id
```

### 调整美化模板

可以按需调整美化模板，上传logo、调整码点码眼、二维码颜色、添加文字等。

![展示二维码API参数说明，含URL构造方法、快速生成链接功能及美化模板选择与自定义调整入口](https://blogcdnimg.clewm.net/2025/02/image-1738725017261_17387250176737.png)

预设了一些美化模板可快捷应用，也可自定义调整美化效果。

![二维码美化工具的预设样式选择界面，提供黑白、简约、经典等多款配色及图标选项供用户自定义生成](https://blogcdnimg.clewm.net/2025/02/image-1738725074076_17387250749118.png)

### 获取美化模板ID

美化模板调整后，点击「完成」，回到API调用界面。会自动生成调整后的美化模板ID ，直接「复制链接」后使用即可。

![该图说明如何通过调整URL参数或使用自动生成功能生成带指定美化模板的二维码下载链接，并提供复制链接与切换模板的操作指引](https://blogcdnimg.clewm.net/2025/02/image-1738725439762_17387254401343.png)