在数字化表彰日益普及的今天，HolyTreasure 团队推出了两款功能互补、风格统一的电子荣誉证书生成 API，分别面向“小猫考试”粉丝排名场景和通用个性化表彰场景。这两款 API 均部署于 https://api.holytreasure.cn，采用现代化技术栈，兼顾易用性、安全性与美观性。
一、小猫考试荣誉证书 API（公开接口）
文档地址：http://doc.holytreasure.cn/?post=2
核心特点：
- 完全公开，无需认证：任何用户均可直接调用，适合快速集成到前端页面或脚本中。
- 极简参数：仅需传入一个整数
rank（1 ~ 999,999），即可生成专属荣誉证书。 - 自动限流：每个 IP 每分钟最多 3 次请求，防止滥用。
- 跨域支持（CORS）：前端 JavaScript 可直接调用，无需后端代理。
- 永久有效图片链接：生成的 PNG 证书通过 CDN 分发，清晰度高且可长期访问。
证书内容示例：
恭喜你成为小猫考试第 888 名粉丝
特颁此奖状以资鼓励！
—— 小猫考试组委会
2025年12月23日
典型使用场景：
- “小猫考试”粉丝排行榜展示
- 社交媒体互动活动中的成就奖励
- 轻量级自动化表彰系统
✅ 适合个人开发者、社区运营者快速实现趣味性荣誉激励。
二、自定义文字证书 API（授权接口）
文档地址：http://doc.holytreasure.cn/?post=3
核心特点：
- 需 API Key 认证：通过邮件申请专属密钥（
X-API-Key），确保服务安全可控。 - 高度可定制：支持自定义三项核心内容：
- 活动名称（最多 6 个字符，超长自动截断为“…”）
- 获奖人姓名（≤30 字符）
- 颁发单位（≤30 字符）
- 不支持 CORS：必须通过后端服务器代理调用，避免密钥泄露。
- 专业排版：正文自动格式化为两行正式表彰语句，符合传统证书风格。
证书内容示例：
在“2025年春…”活动中
李四 同志，表现突出，兹授予此证书以示鼓励。
—— XX市教育局
2025年12月26日
典型使用场景：
- 学校/机构的竞赛颁奖
- 企业内部员工表彰
- 开源社区贡献者认证
- 教育类应用中的成就系统
🔒 适用于对安全性、品牌一致性有要求的组织或商业项目。
对比总结
| 特性 | 小猫考试荣誉证书 API | 自定义文字证书 API |
|---|---|---|
| 认证方式 | 无（公开） | 需 X-API-Key |
| 调用方式 | GET + Query 参数 | POST + JSON Body |
| 前端直调 | ✅ 支持 | ❌ 必须后端代理 |
| 内容灵活性 | 固定模板（仅排名） | 可自定义活动、姓名、单位 |
| 适用对象 | 个人/轻量级项目 | 机构/正式表彰场景 |
| 限流策略 | 3 次/分钟/IP | 未明确说明（由管理员控制） |
结语
HolyTreasure 的这两款证书 API 形成了“轻量趣味”与“专业定制”的完整产品矩阵。无论你是想为粉丝生成一枚可爱的排名奖状，还是为正式活动颁发权威电子证书，都能找到合适的解决方案。两款 API 均基于高清模板、PNG 输出、HTTPS 安全传输，并部署于阿里云，保障稳定可靠。
如需接入自定义证书 API，请发送邮件至 holytreasure@163.com 申请授权。
祝你在“小猫考试”中取得好成绩，也愿你的每一次表彰都充满仪式感！
—— HolyTreasure 开发组 · 2025年12月