跳到主内容
版本: 1.x

理解 WooCommerce REST API

WooCommerce REST API 就像一组标准化的“通道”,让店铺所有者能够将 WooCommerce 店铺连接到其他应用和服务。

下面用简单的方式说明它的工作原理:

  1. 它充当 WooCommerce 店铺与外部应用之间的桥梁,让双方能够通信并共享数据。

  2. API 通过向特定的 端点 发送请求来工作——可以把它们想象成不同类型店铺数据的“通道”。例如,产品、订单和客户各有对应的端点。

  3. 外部应用可以通过这些端点:

  • 获取信息(例如获取产品列表)
  • 添加新数据(例如创建新订单)
  • 更新现有信息(例如更改产品价格)
  • 删除数据(例如移除过时的产品)

与许多传统 WordPress 插件依赖 PHP 钩子和筛选器不同,它通过结构化且可预测的格式(即 JSON)发送和接收数据。

wc-rest-api

在 POS 中查看 JSON 数据​

为了帮助您了解 POS“看到”的内容,我们在界面的许多部分提供了 JSON 视图。 例如,在 POS 中编辑订单元数据或购物车行项目时,您会看到 JSON 标签(如下方截图所示)。

在 POS 中编辑行项目

查看 POS 中行项目的 JSON 数据

浏览器还提供 Network Inspector(网络检查器),可用于监控浏览器与服务器之间发送和接收的数据,其中包括 JSON 数据。

浏览器中的 Network Inspector

浏览器中的 Network Inspector

为什么有些插件无法在 POS 中使用?​

WCPOS 通过 REST API 从 WooCommerce 店铺下载产品、订单和客户数据。 随后,它会在本地保留这些数据的副本,因此即使网络连接不稳定,也能继续运行。 这种方式让 POS 在繁忙的结账环境中运行得更快、更可靠。

不过,这也意味着 POS 无法“看到”网站上实时发生的动态变化。例如:

插件类型无法使用的原因
动态定价

如果店铺中的另一个插件为每位 已登录客户计算专属价格,POS 不会自动获取该个性化 价格。

产品附加项

如果店铺中的另一个插件添加了额外的产品数据,POS 不会 自动获取这些数据。POS 只能获取通过 REST API 公开的数据。

后续步骤​

如需深入了解技术细节,请参阅 WooCommerce 官方 REST API 文档: https://woocommerce.github.io/woocommerce-rest-api-docs/