WooCommerce REST API 是一個(gè)強(qiáng)大而靈活的接口系統(tǒng)，適合希望將商店連接到第三方服務(wù)的使用者和開發(fā)人員。本文將幫助你了解 REST API 的基本用法、密鑰生成流程、常見問題排查等內(nèi)容。

什么是 WooCommerce REST API？

它是 WooCommerce 提供的一種接口，用于與外部系統(tǒng)（如 ERP、APP、小程序、庫存系統(tǒng)等）交互商品、訂單、客戶等數(shù)據(jù)。大多數(shù)情況下，只需要生成 API 密鑰，并輸入到第三方系統(tǒng)中，即可建立連接。

開始前的準(zhǔn)備：固定鏈接設(shè)置

REST API 依賴 WordPress 固定鏈接結(jié)構(gòu)運(yùn)行。在開始前，檢查網(wǎng)站固定鏈接格式是否已設(shè)置為非“純文本”。

路徑：
WordPress 后臺(tái) > 設(shè)置 > 固定鏈接
推薦選擇：“日和名”格式，或其他結(jié)構(gòu)化形式

步驟一：生成 WooCommerce API 密鑰

WooCommerce 使用密鑰機(jī)制管理訪問權(quán)限。每組密鑰與一個(gè) WordPress 用戶綁定。

操作步驟如下：

• 登錄 WordPress 后臺(tái)
• 進(jìn)入 WooCommerce > 設(shè)置 > 高級(jí) > REST API
  如果你使用的是 WooCommerce 3.4 之前版本，路徑為：設(shè)置 > API > Key/Apps
• 點(diǎn)擊“添加密鑰（Add Key）”

• 填寫以下信息：
  • 描述：為密鑰命名，便于識(shí)別
  • 用戶：選擇一個(gè) WordPress 用戶
  • 權(quán)限：
    • Read（只讀）
    • Write（只寫）
    • Read/Write（讀寫）
• 點(diǎn)擊“生成 API 密鑰（Generate API Key）”

系統(tǒng)將提供以下內(nèi)容：

• Consumer Key（消費(fèi)者密鑰）
• Consumer Secret（消費(fèi)者秘鑰）
• 二維碼
• 撤銷按鈕

將密鑰和站點(diǎn)地址輸入到外部系統(tǒng)后，連接即可建立。

步驟二：測試 API 是否正常

可在瀏覽器或使用 Postman 工具測試以下鏈接：

https://yourdomain.com/wp-json/wc/v3/orders?consumer_key=ck_xxx&consumer_secret=cs_xxx

如出現(xiàn) 401 錯(cuò)誤或提示“woocommerce_rest_cannot_view”，請(qǐng)檢查以下項(xiàng)目：

• 密鑰是否正確
• 權(quán)限是否設(shè)置為“讀寫”
• 服務(wù)器是否正確傳遞了身份驗(yàn)證信息

為確認(rèn)服務(wù)器支持 Auth 頭部，也可以臨時(shí)在 .htaccess 中添加以下內(nèi)容：

SetEnvIf Authorization .+ HTTP_AUTHORIZATION=$0
RewriteRule ^wp-json/.* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization},L]

Legacy REST API（舊版接口）

WooCommerce 曾使用 Legacy REST API 系統(tǒng)，在 WooCommerce 9.0 后，此功能將遷移到獨(dú)立插件。

如當(dāng)前仍有舊系統(tǒng)依賴，可按照以下方法啟用：

后臺(tái)進(jìn)入：WooCommerce > 設(shè)置 > 高級(jí) > Legacy API
勾選“啟用 Legacy REST API”

新版 REST API 與 WordPress 原生系統(tǒng)整合，并為默認(rèn)啟用狀態(tài)，建議遷移使用新版。

常見問題解答

Q：請(qǐng)求時(shí)出現(xiàn) 401 錯(cuò)誤或“woocommerce_rest_cannot_view”？
請(qǐng)檢查以下內(nèi)容：

• API 密鑰是否正確
• 權(quán)限是否設(shè)置為讀寫
• 身份驗(yàn)證信息是否通過正確方式傳遞，可嘗試將密鑰附加到 URL 參數(shù)中進(jìn)行測試

總結(jié)

WooCommerce REST API 提供了強(qiáng)大的數(shù)據(jù)交互能力，適用于庫存同步、訂單推送、APP 對(duì)接等多種場景。只需完成密鑰生成、權(quán)限配置和基礎(chǔ)測試，即可順利開始外部系統(tǒng)的連接過程。

如果你在尋找一種自動(dòng)化、可擴(kuò)展的商店數(shù)據(jù)對(duì)接方式，REST API 是 WooCommerce 中不可忽視的重要工具。

聯(lián)系我們
教程看不懂？聯(lián)系我們?yōu)槟赓M(fèi)解答！免費(fèi)助力個(gè)人，小企站點(diǎn)！	客服微信
① 電話：020-2206-9892
② QQ咨詢：1025174874
③ 郵件：info@361sale.com
④ 工作時(shí)間：周一至周五，9:30-18:30，節(jié)假日休息