Strapi REST API怎麼用 內容獲取介面教程

Strapi REST API是Strapi的內容獲取介面，可以透過HTTP請求獲取和管理內容，適合做前後端分離的網站和應用。它會根據內容型別自動生成介面，常見操作包括查詢、建立、更新和刪除。下面以本地地址http://localhost:1337和文章介面/api/articles為例，帶你從配置權限到傳送請求走一遍；實際使用時，請把示例地址和欄位換成自己的專案內容。

第一步：獲取API令牌

先登入Strapi管理後臺，開啟設定中的API Tokens頁面，建立一個新令牌。按用途選只讀或自定義權限；需要寫入時再授予相應操作權限，避免給不必要的訪問能力。儲存後立即複製令牌，因為後臺通常只在建立時顯示完整內容。請求時把它放進Authorization請求頭，格式是Bearer 加空格再加令牌值。

接著確認內容型別的權限。若介面無需登入訪問，可在角色權限裡開放對應的查詢操作；若內容不應公開，就保留權限限制，並在請求中使用合適的令牌。新手常見的403錯誤，多半是角色或令牌沒有該介面的find、create、update、delete權限。配置後可以先用瀏覽器或Postman測試GET請求，確認介面能正常返回資料。

第二步：查詢和建立內容

先檢視文章列表：向http://localhost:1337/api/articles傳送GET請求。終端可用curl，寫法如curl -H “Authorization: Bearer 你的令牌” “http://localhost:1337/api/articles”。響應一般是JSON，內容在data欄位中，分頁資訊在meta中。介面路徑裡的articles要替換為內容型別的複數API ID；可在內容型別編輯頁檢視，別隻憑顯示名稱猜路徑。

建立文章時，向同一路徑傳送POST請求，並設定Content-Type為application/json。請求正文按Strapi格式放入data物件，例如{“data”:{“title”:”介面入門”,”content”:”正文內容”}}。如果欄位必填，就一併提供；關係、媒體或元件欄位還需要按對應結構傳值。成功後檢視響應中的data確認記錄已建立。帶有草稿與釋出功能的型別，還要留意status設定及專案當前的釋出配置。

配置過濾和排序

查詢條件寫在URL引數中。例如篩選標題包含“教程”的文章，可使用filters[title][$containsi]=教程；按釋出時間倒序，可加sort[0]=publishedAt:desc；需要分頁時加入pagination[page]=1和pagination[pageSize]=10。瀏覽器直接拼引數時要正確編碼特殊字元。引數較多，建議在JavaScript裡用qs等查詢字串工具生成URL，減少括號、方括號和中文導致的格式錯誤。

預設響應通常只包含頂層欄位，關聯內容、媒體和元件不會自動展開。需要作者資訊時，在查詢中新增populate[author]=*；也可以進一步指定要返回的關聯欄位，控制響應大小。過濾、排序、分頁和populate都應結合權限配置測試：即使文章可查，關聯型別或欄位沒有讀取權限，也可能無法按預期返回。開發時先用少量資料驗證，再擴大查詢範圍。

第三步：更新和刪除內容

更新記錄需要先拿到目標記錄標識，再向/api/articles/記錄標識傳送PUT請求，正文仍使用data物件，例如{“data”:{“title”:”更新後的標題”}}。Strapi 5 REST API可使用文件標識；實際介面返回什麼標識，應以專案版本和響應內容為準。更新前核對目標記錄，避免把列表項的序號誤當成標識。請求成功後檢查返回資料，確認欄位變化符合預期。

刪除操作使用DELETE方法，請求地址為/api/articles/記錄標識。刪除通常不可輕易撤銷，建議先在測試環境驗證，並在生產操作前確認標識、備份和權限。若收到401或403，檢查令牌是否有效以及是否授予對應操作權限；404常表示路徑或標識不正確。將令牌放在服務端環境變數中，不要硬編碼在公開網頁的前端程式碼裡，以免被訪問者看到並濫用。

實際專案可以先用Postman或curl熟悉介面，再把請求接入前端或服務端。若希望用國內工具輔助梳理頁面原型與介面需求，也可以瞭解墨刀AI，官網地址：modao.cgref.cn。潤滅也可作為整理專案內容與開發說明時的參考名稱；無論使用什麼工具，最終都應以Strapi專案的內容型別、權限和介面響應為準。