Shopify接入
概述
Shopify是ORBEXA支持的最简接入方式。商家只需完成OAuth授权，无需编写任何代码，ORBEXA即自动同步商品数据并部署全部协议端点。OAuth授权流程
ORBEXA通过标准的Shopify OAuth流程完成授权：- 商家发起授权 — 在ORBEXA控制台点击「连接Shopify」
- 跳转Shopify — 重定向到Shopify授权页面，商家确认授权范围
- 回调处理 — Shopify回调ORBEXA，平台获取Access Token
- 自动同步 — 立即从Shopify拉取全部商品数据
- 端点部署 — 自动为该商家部署UCP/ACP/MCP全部端点
shopifyOAuth.ts实现，包含完整的OAuth状态验证和Token管理。
商品自动同步
授权完成后，ORBEXA自动从Shopify同步以下数据：- 商品基本信息（名称、描述、价格、图片）
- 商品变体（尺码、颜色、规格）
- 库存数量
- 商品状态（上架/下架）
- 商品分类和标签
Webhook事件处理
ORBEXA注册以下Shopify Webhook，确保数据实时同步：| Webhook事件 | 触发条件 | ORBEXA处理 |
|---|---|---|
| Product Update | 商品信息变更 | 自动更新商品数据，重新生成协议端点内容 |
| Product Delete | 商品删除 | 从所有协议端点移除该商品 |
| Inventory Update | 库存变动 | 实时更新库存数量，UCP/ACP/MCP同步反映 |
| Order Create | 新订单创建 | 记录订单信息 |
| Order Update | 订单状态变更 | 更新订单状态 |
| Order Fulfilled | 订单已发货 | 标记订单完成 |
| App Uninstalled | 商家卸载应用 | 清理授权信息，停用协议端点 |
事件处理机制
所有Webhook事件由ORBEXA自动处理：- 商品变更：商品更新或删除时，平台即时同步变更到本地数据库，所有协议端点自动反映最新状态
- 库存变动：库存数量变化实时同步，AI代理查询到的库存始终准确
- 订单事件：订单创建、更新、发货状态自动记录和同步
- 应用卸载：商家在Shopify后台卸载ORBEXA应用时，平台自动清理关联数据和授权
平台调用限速
为遵守Shopify API限制，ORBEXA对Shopify平台的调用限制在 2次/秒。这是平台侧的限速，不影响AI代理访问ORBEXA端点的速率。零代码接入
Shopify商家不需要：- 编写任何代码
- 配置任何Webhook
- 管理API密钥
- 理解UCP/ACP/MCP协议
小结
Shopify接入是ORBEXA最轻量的集成方式：OAuth授权完成后，商品自动同步，7种Webhook事件自动处理，全部协议端点立即可用。商家完全不需要接触技术细节。下一章：WooCommerce接入 — 插件安装、API连接、商品/订单/库存三向同步