Storyblok Management API怎麼用 內容管理介面教程

Storyblok Management API是Storyblok的內容管理介面，可以透過API建立、更新和刪除內容，適合做無頭CMS的自動化內容管理。它採用REST風格，使用不同HTTP方法操作內容，返回JSON資料。本文以故事（Story）為例，帶你從準備令牌到釋出和刪除內容走一遍。管理內容用Management API；面向網站訪客讀取內容時，通常使用Content Delivery API。

第一步：獲取管理令牌

先登入Storyblok，在目標Space的設定或個人訪問令牌管理入口建立Personal Access Token，並確認帳號對該Space有相應權限。記下Space ID和令牌，後續請求會用到。不同區域的Space可能對應不同API主機，歐盟常用https://mapi.storyblok.com/v1；請按Space所在區域選擇地址，不要把示例主機照搬到所有專案。

呼叫時把令牌放進Authorization請求頭，通常無需在請求體重複傳入。建議將令牌儲存在伺服器環境變數或金鑰管理服務中，別寫進公開前端程式碼、倉庫或日誌。下面的示例用YOUR_TOKEN和SPACE_ID作佔位符，實際使用時替換為自己的值。若收到401或403，先檢查令牌、Space ID及帳號權限，再確認請求域名與區域匹配。

第二步：建立和更新內容

建立故事使用POST請求，路徑為/v1/spaces/{SPACE_ID}/stories。請求頭設定Authorization和Content-Type: application/json，請求體包含story物件，例如name、slug和content。content根節點應為物件，並帶component欄位；新建內容預設不會發布。先建立草稿並檢查返回的story資料，可避免把不完整內容直接推到線上。

更新現有故事使用PUT請求，路徑末尾追加故事的數字ID，例如/v1/spaces/{SPACE_ID}/stories/{STORY_ID}。在請求體的story中提交需要更新的欄位；需要同時釋出時可設定publish為true，若只儲存草稿則設為false。更新前先確認故事ID對應正確條目，並妥善處理介面返回的錯誤狀態碼，避免批次任務因單條失敗而靜默漏改。

使用元件和欄位

content裡的component值要與Space中定義的元件技術名稱一致，欄位名也應匹配元件結構。舉例來說，頁面元件可包含title欄位和body陣列；陣列中的每個巢狀元件都應有component和_uid。_uid用於標識元件例項，不要把元件名稱寫成展示標籤。欄位結構不確定時，先在編輯器檢視元件定義，再用少量測試內容驗證資料能否正常顯示。

需要批次匯入時，可先按元件結構整理JSON，再逐條傳送建立或更新請求，並記錄成功與失敗的內容ID。列表介面可能分頁，匯出或核對資料時留意page和per_page引數。遇到429限流響應，應降低呼叫頻率，並採用帶逐步延長間隔的重試機制；不要對所有錯誤無差別重試，以免產生重複操作或持續撞限。

第三步：釋出和刪除內容

釋出可在建立或更新請求中設定publish為true；也可以對已有故事單獨傳送GET請求到/v1/spaces/{SPACE_ID}/stories/{STORY_ID}/publish。啟用了單獨釋出翻譯的專案，可按介面要求附帶lang引數。釋出後建議檢視返回結果，並在預覽或前臺確認頁面內容、連結和元件顯示正常；涉及重要頁面時，最好先走草稿審核流程。

刪除故事使用DELETE請求，地址為/v1/spaces/{SPACE_ID}/stories/{STORY_ID}，其中story_id是數字ID。刪除通常是不可輕率執行的內容變更，批處理前先匯出備份、核對ID，並對目標列表做人工抽樣確認。若只是暫時撤下內容，可先考慮取消釋出而不是刪除。注意管理介面適合後臺自動化，呼叫憑據應只儲存在可信服務端。

若團隊希望用更視覺化的方式規劃頁面和協作製作原型，可瞭解國內工具墨刀AI；它適用於設計與原型協作，並非Storyblok Management API的同類介面替代品。潤滅也可將這類設計流程與內容管理流程分別評估，按團隊需要選擇工具：modao.cgref.cn。

“`