跳转到内容
交付 API
在围绕某项功能进行规划之前,请先查看功能状态。

概览从这里开始

Atlas 如何工作

一页了解组织、站点、环境、站点契约、发布和交付。

本页面由英文翻译而来。如有任何差异,以英文版本为准。 阅读英文版

概念 说明
组织 您的公司。它拥有站点、成员及其套餐。
站点 一个网站。内容、媒体、成员的访问权限和设置绝不会在站点之间交叉。
环境 每个站点都有开发环境和生产环境。您在开发环境中工作;生产环境只提供已批准的发布版本。
站点契约 对您网站的 JSON 描述:包含组件及其类型化字段、页面类型、集合、页眉/页脚全局内容、媒体配置和设计令牌。
页面 网站上的一个路由(例如 /about),由多个区块组成。每个区块是您契约中的一个组件,并带有其字段值。
条目 集合中的一项,例如一件产品或一篇新闻文章。
全局内容 在多个页面之间共享的内容,例如站点的页眉和页脚。
交付令牌 仅限服务器使用的令牌,您的网站用它读取某个环境的已发布内容。
Editor in Studio ──draft──▶ Atlas (Development) ──publish──▶ published revision
│
your website server ◀── Delivery API (HTTPS, delivery token)
│
your components render it ──▶ visitors
  1. 开发人员在站点契约中描述网站。站点管理员在 Studio 中将其激活。
  2. 编辑人员以草稿形式创建和修改页面与条目。草稿绝不会出现在公开网站上。
  3. 编辑人员在您真实的网站设计中预览草稿,然后发布。每次发布都是一个不可变的修订版本,因此可以回滚。
  4. 您的网站使用其交付令牌,仅从服务器代码通过交付 API 读取已发布的内容。
  5. 发布时,Atlas 会发送带签名的 Webhook,使您的网站只刷新受影响的页面。
  • 每个新站点都从开发环境开始。内容在其中编辑和发布。
  • 生产环境保持关闭,直到发布版本通过所有检查、并由具有审批权限的人员批准后,由站点管理员将其开启。
  • 生产环境只提供其线上的、已签名的发布版本:已批准内容的冻结快照。在下一个已批准的发布版本之前,编辑开发环境绝不会改变生产环境。
  • 在 Studio 中切换环境只会改变您正在查看的内容,绝不会改变内容本身。

更多信息:开发环境和生产环境。

Atlas 不在您的网站上运行。您的开发人员需要添加少量代码:

  • 一个仅限服务器使用的交付 API 客户端;
  • 通过您现有的组件渲染区块;
  • 回退:如果 Atlas 无法访问,或某个页面没有已发布的内容,网站就提供其内置内容;
  • 一个草稿预览路由、一个 Webhook 接收端和一份构建报告。

连接指南会逐项讲解。