WooCommerce接入
概述
WooCommerce接入通过REST API实现，提供完整的商品、订单和库存三向同步。与Shopify的OAuth授权不同，WooCommerce需要商家提供API密钥完成连接。API端点
ORBEXA为WooCommerce集成提供以下端点（通过woocommerceRouter.ts实现）：
连接管理
| 端点 | 方法 | 功能 |
|---|---|---|
/api/integrations/woocommerce/connect | POST | 连接WooCommerce商店 |
/api/integrations/woocommerce/test | POST | 测试连接是否正常 |
数据同步
| 端点 | 方法 | 功能 |
|---|---|---|
/api/integrations/woocommerce/sync/products | POST | 同步商品数据 |
/api/integrations/woocommerce/sync/orders | POST | 同步订单数据 |
/api/integrations/woocommerce/sync/inventory | POST | 同步库存数据 |
Webhook管理
| 端点 | 方法 | 功能 |
|---|---|---|
/api/integrations/woocommerce/webhooks/setup | POST | 注册Webhook |
/api/integrations/woocommerce/webhooks/handle | POST | 接收Webhook事件 |
连接流程
步骤1：生成WooCommerce API密钥
商家在WooCommerce后台（Settings — Advanced — REST API）创建API密钥，获取Consumer Key和Consumer Secret。步骤2：连接商店
通过/api/integrations/woocommerce/connect端点提交：
- WooCommerce商店URL
- Consumer Key
- Consumer Secret
步骤3：测试连接
调用/api/integrations/woocommerce/test端点验证连接是否成功。ORBEXA会尝试访问WooCommerce REST API确认凭据有效。
步骤4：同步数据
连接成功后，分别调用三个同步端点拉取商品、订单和库存数据。三向同步
商品同步
- 从WooCommerce拉取全部商品数据
- 包含名称、描述、价格、图片、变体、分类
- 进入AI Refinery Pipeline自动清洗
- 同步到所有协议端点
订单同步
- 同步WooCommerce订单到ORBEXA
- 支持ACP
commerce.order_status查询 - 订单状态变更实时反映
库存同步
- 实时同步库存数量
- UCP/ACP/MCP端点的库存查询始终反映最新状态
- 库存不足时AI代理可获知准确信息
Webhook配置
通过/api/integrations/woocommerce/webhooks/setup端点一键注册所有Webhook。注册后，WooCommerce会在以下事件发生时自动通知ORBEXA：
- 商品创建/更新/删除
- 订单创建/更新
- 库存变动
/api/integrations/woocommerce/webhooks/handle端点统一处理。
平台调用限速
ORBEXA对WooCommerce API的调用限制在 5次/秒，确保不超过WooCommerce服务器的承载能力。这是平台侧的限速，AI代理访问ORBEXA端点不受此限制。与Shopify接入的对比
| 特性 | Shopify | WooCommerce |
|---|---|---|
| 授权方式 | OAuth自动授权 | API密钥手动配置 |
| 初始设置 | 零代码 | 需要生成API密钥 |
| Webhook | 自动注册 | 调用setup端点注册 |
| 平台限速 | 2次/秒 | 5次/秒 |
| 数据同步 | 自动触发 | 手动或Webhook触发 |
小结
WooCommerce接入提供完整的商品/订单/库存三向同步，7个API端点覆盖连接、同步和Webhook全流程。配置完成后，数据自动流入ORBEXA的协议端点栈。下一章：WordPress插件接入 — 一键连接、自动创建商家账户和API密钥