API 概述
CodeBox 二维码 API,只需传入 content 即可生成二维码
简介
CodeBox 提供 RESTful API,只需传入 content 字段即可生成二维码,支持自定义样式。
最简调用:
curl -X POST https://www.codebox.club/api/v1/qrcode/generate \
-H "Content-Type: application/json" \
-d '{"content": "https://example.com"}' \
-o qrcode.pngBase URL
https://www.codebox.club/api/v1/qrcode认证(可选)
API 无需认证即可使用。认证后可获得更高的调用频率。
API Key
Authorization: Bearer cb_sk_xxxxxxxxxxxxxxxxAPI Key 可在后台「设置 → API Key」中创建。
Session
登录后的浏览器会话自动携带认证信息。
频率限制
| 用户类型 | 频率限制 | 最大尺寸 |
|---|---|---|
| 匿名用户 | 10 次/分钟 | 1000px |
| 登录用户 | 60 次/分钟 | 2000px |
| API Key | 自定义 | 2000px |
接口
| 接口 | 方法 | 说明 |
|---|---|---|
| /generate | POST | 生成二维码图片 |
错误码
| 状态码 | 说明 |
|---|---|
| 200 | 成功 |
| 400 | 参数错误 |
| 401 | API Key 无效 |
| 429 | 频率超限 |
| 500 | 服务器错误 |