跳到內容
Delivery API
在規劃採用某項功能之前,請先查看功能狀態。

總覽從這裡開始

Atlas 如何運作

以一頁說明組織、網站、環境、網站合約、發布與內容傳遞。

本頁翻譯自英文。若內容有任何差異,以英文版為準。 閱讀英文版

概念 說明
組織 您的公司。組織擁有網站、成員及其方案。
網站 一個網站。內容、媒體、成員的存取權限與設定絕不會在網站之間互通。
環境 每個網站都有 Development 與 Production 兩個環境。您在 Development 中作業;Production 只提供已核准的發行版本。
網站合約 以 JSON 描述您的網站:其元件與具型別的欄位、頁面類型、集合、頁首/頁尾全域內容、媒體設定檔與設計代碼(design tokens)。
頁面 網站上的一個路由(例如 /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. 您的網站僅從伺服器端程式碼,使用傳遞權杖透過 Delivery API 讀取已發布的內容。
  5. 發布時,Atlas 會傳送已簽署的 Webhook,讓您的網站只重新整理受影響的頁面。
  • 每個新網站都從 Development 開始。內容在此編輯與發布。
  • Production 預設為關閉,須在發行版本通過所有檢查、且具核准權限的人員核准後,由網站管理員開啟。
  • Production 只提供其正式上線、已簽署的發行版本:即已核准內容的凍結快照。在下一個已核准的發行版本之前,編輯 Development 不會改變 Production。
  • 在 Studio 中切換環境只會改變您目前檢視的對象,絕不會改變內容。

延伸閱讀:Development 與 Production。

Atlas 不會在您的網站上執行。您的開發人員需要加入少量程式碼:

  • 供 Delivery API 使用、僅限伺服器端的用戶端;
  • 透過您現有的元件算繪各區塊;
  • 備援內容:若 Atlas 無法連線,或某個頁面尚無已發布內容,網站會提供其內建內容;
  • 草稿預覽路由、Webhook 接收端與建置回報。

連接指南會逐一說明這些項目。