接口配置
接口配置
每个接口都标记实体类型、同步游标和调度策略。新增接口时先进入原始层,确认稳定后再做标准化。
接口列表
保持接口配置轻量,复杂字段映射放在 transformer 中处理。
| 接口 | 数据源 | 方法 | 路径 | 实体类型 | 游标字段 | 调度 | 状态 |
|---|---|---|---|---|---|---|---|
商品列表 products | Shopify 店铺 | GET | /admin/api/products.json | product | updated_at | 每 2 小时 | 启用 |
订单列表 orders | Shopify 店铺 | GET | /admin/api/orders.json | order | updated_at | 每 30 分钟 | 启用 |
库存快照 inventory_snapshot | 领星 ERP | POST | /erp/sc/data/local_inventory | inventory | snapshot_at | 每天 08:00 | 启用 |
商品广告表现 product_metrics | Google Ads | POST | GoogleAdsService.SearchStream | marketing_metric | segments.date | 每天 06:00 | 停用 |