Cloud CMS SaaS 开发者文档

面向读者

本文档面向需要在 Cloud CMS SaaS 平台上进行站点定制、API 集成、主题开发的租户开发者。

平台概述

Cloud CMS 是一款 SaaS 多租户内容管理服务，您无需关心服务器运维、数据库管理或系统升级——只需专注于内容创作和站点运营。

核心能力

能力	说明
多站点管理	一个账号管理多个独立站点，各自配置独立域名
可视化后台	基于 Web 的管理后台，无需安装任何软件
Headless API	通过 RESTful API 将内容分发到 App、小程序等任意终端
主题市场	多套预设主题，一键切换，支持自定义 CSS/JS
SSO 单点登录	统一账号体系，一次登录访问所有站点
AI 辅助	内置 AI 内容生成、摘要、翻译、智能分类

---

快速集成

Headless CMS API

通过 API 将 Cloud CMS 中的内容对接到您的 App、小程序或其他前端应用。

认证方式

所有 API 请求需在 Header 中携带 API Key：

X-API-Key: 您的API密钥

获取 API Key：登录管理后台 → 系统管理 → API 密钥 → 新建密钥

常用接口

# 获取内容列表
GET https://您的域名/api/mcp/contents?siteId=15&categoryId=1&page=1&size=10

# 获取内容详情
GET https://您的域名/api/mcp/contents/{id}

# 获取分类树
GET https://您的域名/api/mcp/categories/tree?siteId=15

# 获取站点信息
GET https://您的域名/api/mcp/site/info?siteId=15

响应格式

{
  "success": true,
  "data": {
    "items": [
      {
        "id": 1,
        "title": "文章标题",
        "intro": "文章摘要",
        "coverImages": "/uploads/cover.jpg",
        "publishAt": "2024-01-01T00:00:00Z"
      }
    ],
    "total": 100,
    "page": 1,
    "size": 10
  }
}

AI 技能 API

Cloud CMS 提供 AI 技能接口，支持内容生成、翻译等功能：

# AI 生成文章
POST https://您的域名/api/skills/generate/article
{ "siteId": 15, "topic": "行业趋势分析", "words": 1000, "style": "professional" }

# AI 生成摘要
POST https://您的域名/api/skills/generate/summary
{ "content": "长文本内容...", "maxLength": 200 }

# AI 翻译
POST https://您的域名/api/skills/translate
{ "content": "需要翻译的内容", "targetLang": "en" }

---

主题定制

Cloud CMS 支持主题定制，您可以通过修改主题文件来个性化您的站点外观。

主题结构

主题文件位于 /themes/ 目录下，主要包括：

• layouts/ - 布局模板
• templates/ - 页面模板
• assets/ - CSS、JS、图片等静态资源
• locales/ - 国际化文件

静态资源引用

在模板中引用主题资源：

<link rel="stylesheet" href="/themes/15/mdh/css/theme.css">
<script src="/themes/15/mdh/js/theme.js"></script>

---

模板标签系统

Cloud CMS 提供模板标签系统，用于在模板中调用各种功能组件。

提示

详细的模板标签用法和示例，请参考完整的技术文档。

模板语法参考

Cloud CMS 模板使用 .j2 扩展名，语法与 Jinja2 类似。

提示

详细的模板语法示例和用法请参考完整的技术文档。

功能模块指南

Cloud CMS 提供多个功能模块，支持在模板中灵活调用。

自定义菜单

在后台 内容管理 → 自定义菜单 中创建导航菜单：

1. 新建菜单，设置 标识符(Code) 和 标签(Tag)
2. 添加菜单项（支持多级嵌套、图标、排序）
3. 在主题模板中通过相应组件调用

内容标签

在后台 内容管理 → 内容标签 中创建可复用的内容模块：

类型	说明	典型场景
menu	菜单	导航栏
taxonomy	分类	产品分类展示
posts	文章列表	最新文章、热门文章

SEO 优化

Cloud CMS 内置 SEO 功能，支持：

• 自定义页面标题和 Meta 描述
• 自动生成 Sitemap
• Open Graph 标签支持
• 结构化数据 (Schema.org)

广告系统

支持在站点中插入广告位，可通过后台管理广告内容：

1. 创建广告位
2. 添加广告内容（支持图片、文字、HTML）
3. 在模板中调用广告位

---

最佳实践

内容运营

• 定期更新内容，保持站点活跃度
• 使用 AI 辅助功能提高内容生产效率
• 合理使用分类和标签组织内容

API 集成

• 合理使用 API 频率限制
• 实现错误处理和重试机制
• 注意 API 密钥的安全保管

安全建议

• 定期更换 API 密钥
• 使用 HTTPS 进行 API 调用
• 避免在客户端暴露敏感信息

---

常见问题

Q: 可以自定义主题样式吗？ A: 可以。在后台主题编辑器中修改 CSS/JS，或联系技术支持深度定制。

Q: 支持多语言站点吗？ A: 支持。可通过多站点功能为不同语言创建独立站点。

Q: API 调用有频率限制吗？ A: 有合理的频率限制，正常业务使用不会受到影响。如有特殊需求可联系技术支持。

---

相关资源

• 用户指南
• AI 智能体参考