Skip to main content

Cloud CMS SaaS 开发者文档

::: tip 面向读者 本文档面向需要在 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">

模板标签系统​

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

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

模板语法参考​

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

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

功能模块指南​

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: 有合理的频率限制，正常业务使用不会受到影响。如有特殊需求可联系技术支持。

相关资源​