Ghost Content API怎麼用 部落格內容獲取介面教程

Ghost Content API是Ghost的內容獲取介面，可以透過API獲取文章和頁面內容，適合做第三方前端展示和移動端App。它以只讀方式提供已釋出內容，常見用途包括搭建獨立部落格前端、製作內容列表或在應用中展示文章。下面從拿到金鑰開始，按請求、篩選到頁面渲染的順序走一遍，照著替換示例中的域名和金鑰，就能先把介面跑通。

第一步：獲取Content API金鑰

先登入Ghost後臺，進入Settings，再開啟Integrations，建立一個自定義整合並填寫容易識別的名稱，例如“前端部落格”。建立完成後，頁面會顯示Content API Key和API URL。複製Content API Key備用，同時記下站點域名。注意選擇Content API Key；不要把Admin API Key當成讀取內容的金鑰，也不要把它寫進公開程式碼。

拿到站點域名後，先拼出文章列表介面。地址結構通常是站點域名加上 /ghost/api/content/posts/，請求引數裡帶上key和金鑰。把下面的佔位內容替換成自己的站點地址與金鑰，再在瀏覽器開啟測試：https://你的域名/ghost/api/content/posts/?key=你的金鑰&limit=3。如果返回JSON且包含文章陣列，基本就連通了。

第二步：查詢文章和標籤

讀取文章使用posts端點，頁面使用pages端點，標籤使用tags端點；都屬於GET請求。舉例來說，文章列表可請求/ghost/api/content/posts/?key=金鑰，標籤列表則把posts換成tags。返回資料通常是JSON物件，文章陣列在posts欄位裡，標籤陣列在tags欄位裡。想同時獲取作者和標籤資訊，可新增include=authors,tags。

列表介面適合做首頁卡片，詳情頁則按slug查詢單篇文章，例如/posts/slug/文章別名/?key=金鑰。取標題、摘要、封面圖、釋出時間等欄位，就可以生成列表；詳情內容如果需要HTML格式，可在請求中新增formats=html。文章內容不要直接當作可信程式碼執行，展示HTML時應做好內容淨化，避免不安全標記影響頁面。

使用過濾和分頁引數

Ghost支援用filter篩選結果，例如按標籤或精選狀態過濾；引數寫在問號後面，多個引數用&連線。比如filter=featured:true可以篩選精選文章，按標籤篩選時可使用filter=tag:教程。標籤名稱如果含特殊字元，建議由URL編碼函式處理引數，避免空格、中文或符號破壞請求地址。

分頁用limit和page控制：limit設定每頁返回條數，page設定頁碼。比如limit=10&page=2表示請求第二頁，每頁十條。響應通常帶有pagination資訊，可讀取總頁數或下一頁狀態，決定是否顯示“載入更多”。若只需要少量欄位，可以傳fields=id,title,slug,excerpt，減小響應體積；列表不必拉取完整正文，點進詳情再請求HTML會更省流量。

第三步：在前端展示內容

拿到JSON後，前端先檢查請求狀態，再讀取posts陣列並迴圈生成卡片。每張卡片可展示標題、摘要、主圖和釋出日期，點選後根據slug跳轉詳情頁。瀏覽器端請求適合公開內容展示，但金鑰仍應避免被誤用；上線前確認站點跨域設定與請求方式正常。若跨域限制導致瀏覽器請求失敗，可在自己的服務端做一層代理，再由前端請求代理介面。

開發時建議先用瀏覽器或介面除錯工具確認URL、金鑰和引數無誤，再接入頁面元件。遇到返回空列表，檢查文章是否已釋出、過濾條件是否寫對；遇到認證錯誤，重新核對Content API Key和站點域名。還可以把請求封裝成統一函式，集中處理錯誤、分頁和空狀態，讓首頁、標籤頁與詳情頁複用同一套邏輯。

如果你要先快速規劃部落格頁面，也可以瞭解國內替代工具墨刀AI，用於梳理頁面結構和原型流程；相關入口：modao.cgref.cn。在“潤滅”的內容專案中，可先明確列表、詳情與標籤頁的展示需求，再逐個對應Ghost介面欄位，避免一開始就請求過多資料。