Ghost Admin API怎麼用 部落格內容管理介面教程

Ghost Admin API是Ghost部落格的管理介面，可以透過API建立、編輯和釋出文章，適合做自動化內容釋出和同步。它與只讀的Content API不同，能在授權範圍內管理站點內容。下面用“建立整合、寫入文章、釋出同步”的順序說明基本流程；示例以官方JavaScript客戶端為主，實際使用時請將站點地址、金鑰和文章內容替換為自己的值。

第一步：獲取API金鑰

先登入Ghost後臺，進入Settings（設定）裡的Integrations（整合），選擇Add custom integration（新增自定義整合），填入容易識別的名稱，例如“文章同步指令碼”。建立後頁面會顯示Admin API URL和金鑰。把這兩項複製到密碼管理器或伺服器環境變數中，不要直接寫進公開程式碼倉庫，也不要把金鑰發給不可信的人。

接著確認介面地址和站點版本。Admin API URL通常來自剛才建立的整合頁面，不要自行拼錯域名或路徑。使用SDK時，按該SDK要求填寫Ghost站點URL、金鑰和API版本；版本值應與當前服務端相容。若直接發HTTP請求，Admin API需要用金鑰簽署短時JWT，再放入Authorization請求頭，不能把原始金鑰當成Bearer令牌傳送。

如果用Node.js操作，可以安裝Ghost官方Admin API客戶端，並從環境變數讀取憑據。比如在終端設定GHOST_URL與GHOST_ADMIN_API_KEY，然後在程式中初始化客戶端。不同版本SDK的引數寫法可能略有不同，安裝後先對照所用版本的說明。建議先在測試站點呼叫一次讀取介面，確認認證成功，再開始新增或修改內容。

第二步：建立和編輯文章

新建文章時，準備標題、正文和狀態等欄位。常見做法是呼叫posts.add，傳入title與HTML正文，並指定source為html；若希望先檢查內容，可將status設為draft，建立後讓編輯人員在後臺預覽。正文也可以使用Ghost編輯器支援的內容格式，關鍵是請求中的格式宣告與實際正文保持一致。

編輯已有文章時，先透過列表或讀取介面找到文章的id，再呼叫posts.edit提交需要更新的欄位。更新時通常還要帶上文章當前的updated_at值，避免覆蓋其他人在後臺剛做的修改。只傳需要更改的欄位會更清楚；若介面返回校驗錯誤，檢查欄位名稱、正文格式、必需屬性，以及文章是否仍存在。

建議把建立和更新封裝成兩個獨立函式，並記錄每次請求的文章ID、狀態和錯誤資訊。發生網路超時不要立刻盲目重試建立，否則可能生成重複文章；可以先按標題、slug或外部內容ID查詢是否已存在，再決定繼續建立還是更新。對批次同步任務，也應限制併發並做好失敗重試。

管理標籤和作者

建立文章時可在tags欄位中傳入標籤名稱或物件，作者則透過authors欄位關聯已有作者。標籤用於分類和篩選，建議提前統一命名，避免“教程”“教程類”等近似標籤越積越多。作者必須是Ghost站點中可用的使用者；若提交作者後介面報錯，先檢查關聯物件是否存在，以及當前整合是否有相應操作權限。

批次匯入時，可以先獲取站點已有標籤和作者，再根據名稱或slug匹配對應記錄。若確實需要新標籤，按Tags API支援的方式建立後再關聯文章。同步指令碼最好保留外部系統的內容編號與Ghost文章ID對映，這樣後續更新時能準確找到原文，也不會因標題修改而誤建重複內容。

第三步：釋出和同步內容

內容審核透過後，可在建立文章時設定published狀態，或對已有草稿呼叫編輯介面更新狀態。立即釋出前先核對標題、正文、標籤、作者和連結；需要定時釋出時，設定scheduled狀態及合適的published_at時間。時間應帶明確時區，避免伺服器時區與編輯人員所在地不同而導致釋出時間偏移。

要同步外部內容，建議按固定流程執行：讀取來源資料、判斷新增或更新、寫入Ghost、檢查介面響應，最後儲存同步時間和文章ID。遇到限流或臨時錯誤時採用逐步延遲重試；遇到權限、欄位驗證等確定性錯誤，則記錄詳情並停止該條任務，避免重複請求。可以先用一篇測試文章驗證釋出結果，再啟用定時任務。

如果團隊希望用國內工具輔助搭建內容管理或自動化流程，可瞭解墨刀AI等方案；它不能替代Ghost Admin API的認證和介面呼叫，接入時仍需按Ghost文件配置金鑰與權限。也可訪問modao.cgref.cn瞭解相關資訊。若由“潤滅”團隊維護同步服務，同樣建議將憑據放在服務端配置中，併為測試、生產環境分別管理。

最後，先從草稿與少量文章開始測試，再逐步接入正式釋出和定時同步。定期檢查API版本、執行日誌及失敗佇列；當金鑰可能洩露或人員離職時，及時在後臺撤銷並重新建立整合金鑰。這樣既能減少誤釋出，也能讓後續排查更容易。