# API Integrator

> API 集成连接器 - 指导电商 API 集成，包括 Shopify API、ERP/CRM 集成和 Webhook 配置

- Skill: `huifer/api-integrator` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add huifer/api-integrator`
- Raw SKILL.md: https://api.skillmd.com/api/skills/huifer/api-integrator/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: huifer (https://skillmd.com/u/huifer)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/huifer/api-integrator

---


# API Integrator 🔗

> 连接你的电商生态系统

API 集成连接器帮助电商商家实现系统间的无缝连接，从 Shopify API 集成到第三方 ERP/CRM 连接，提供完整的 API 集成指南和最佳实践。

---

## 🎯 常用集成场景

### ERP 系统集成
```yaml
目标系统:
  SAP:
    - 复杂度: 高
    - 适合: 大型企业
    - 成本: $[50,000-200,000]

  Oracle NetSuite:
    - 复杂度: 高
    - 适合: 中大型企业
    - 成本: $[25,000-100,000]

  Microsoft Dynamics:
    - 复杂度: 中高
    - 适合: 中型企业
    - 成本: $[20,000-80,000]

  Odoo:
    - 复杂度: 中
    - 适合: 中小企业
    - 成本: $[5,000-30,000]

集成功能:
  - 订单同步
  - 库存管理
  - 产品信息
  - 财务数据
  - 客户信息
```

### CRM 系统集成
```yaml
目标系统:
  Salesforce:
    - 复杂度: 中高
    - 适合: 中大型企业
    - 成本: $[10,000-50,000]

  HubSpot:
    - 复杂度: 中
    - 适合: 中小企业
    - 成本: $[5,000-20,000]

  Microsoft Dynamics 365:
    - 复杂度: 中高
    - 适合: 中大型企业
    - 成本: $[15,000-60,000]

集成功能:
  - 客户数据同步
  - 订单历史
  - 营销自动化
  - 客户服务
  - 销售管道
```

### 会计软件集成
```yaml
目标系统:
  QuickBooks:
    - 复杂度: 低
    - 适合: 小型企业
    - 成本: $[2,000-10,000]

  Xero:
    - 复杂度: 低
    - 适合: 小型企业
    - 成本: $[2,000-10,000]

  Sage:
    - 复杂度: 中
    - 适合: 中小型企业
    - 成本: $[5,000-20,000]

集成功能:
  - 订单同步
  - 发票生成
  - 库存价值
  - 财务报表
  - 税务计算
```

---

## 🔌 Shopify API

### API 基础
```yaml
认证方式:
  API 密钥:
    - Admin API
    - 用于服务端集成
    - 需要 API 密钥和密码

  Access Token:
    - Admin API
    - 用于特定应用
    - 更安全的方式

  OAuth 2.0:
    - 用于公共应用
    - 用户授权流程

API 版本:
  - REST Admin API
  - GraphQL Admin API
  - Storefront API
  - Liquid (模板)

速率限制:
  - 漏桶算法
  - 40 请求/秒 (标准)
  - 80 请求/秒 (Plus)
```

### 常用 API 端点
```yaml
REST API:
  产品:
    GET /admin/api/[version]/products.json
    POST /admin/api/[version]/products.json
    PUT /admin/api/[version]/products/[id].json
    DELETE /admin/api/[version]/products/[id].json

  订单:
    GET /admin/api/[version]/orders.json
    GET /admin/api/[version]/orders/[id].json
    POST /admin/api/[version]/orders.json

  客户:
    GET /admin/api/[version]/customers.json
    POST /admin/api/[version]/customers.json

  库存:
    GET /admin/api/[version]/inventory_levels.json
    POST /admin/api/[version]/inventory_levels/adjust.json

GraphQL API:
  - 更高效的数据查询
  - 单次请求多个资源
  - 类型安全
  - 更好的性能
```

### 最佳实践
```yaml
性能优化:
  - 批量操作
  - 使用 GraphQL
  - 缓存数据
  - 异步处理

错误处理:
  - 重试机制
  - 指数退避
  - 错误日志
  - 监控告警

安全措施:
  - 使用 HTTPS
  - 验证输入
  - 限制权限
  - 定期轮换密钥
```

---

## 🔔 Webhook 配置

### Webhook 设置
```yaml
Webhook 事件:
  订单事件:
    - orders/create
    - orders/updated
    - orders/paid
    - orders/cancelled
    - orders/fulfilled

  产品事件:
    - products/create
    - products/update
    - products/delete

  客户事件:
    - customers/create
    - customers/update
    - customers/delete

  库存事件:
    - inventory_levels/update
    - inventory_levels/connect
    - inventory_levels/disconnect

配置步骤:
  1. 创建 Webhook 端点
  2. 验证 Webhook 请求
  3. 处理 Webhook 数据
  4. 返回响应
  5. 错误处理和重试
```

### Webhook 处理
```yaml
验证签名:
  - HMAC-SHA256
  - 验证数据完整性
  - 防止伪造请求

处理流程:
  1. 接收 Webhook
  2. 验证签名
  3. 解析数据
  4. 业务逻辑处理
  5. 返回 200 OK
  6. 错误时返回非 200

重试机制:
  - Shopify 自动重试
  - 最多 19 次
  - 指数退避
  - 最终失败通知
```

---

## 🛠️ 集成开发

### 开发流程
```yaml
Phase 1: 需求分析
  明确需求:
    - 集成目标
    - 数据流向
    - 触发条件
    - 业务规则

  技术评估:
    - API 可用性
    - 数据结构
    - 限制条件
    - 安全要求

Phase 2: 设计
  架构设计:
    - 系统架构
    - 数据流程
    - 错误处理
    - 监控日志

  接口设计:
    - API 映射
    - 数据转换
    - 同步策略
    - 事务处理

Phase 3: 开发
  开发任务:
    - API 客户端开发
    - 数据映射
    - 业务逻辑
    - 错误处理

  测试:
    - 单元测试
    - 集成测试
    - 端到端测试
    - 性能测试

Phase 4: 部署
  部署步骤:
    - 生产环境配置
    - API 密钥管理
    - 监控配置
    - 文档交付
```

### 数据同步策略
```yaml
实时同步:
  - Webhook 触发
  - 低延迟
  - 高资源消耗
  - 适合关键数据

定时同步:
  - 批量处理
  - 低资源消耗
  - 有延迟
  - 适合非实时数据

增量同步:
  - 只同步变化
  - 高效
  - 需要时间戳
  - 推荐方式

全量同步:
  - 同步全部数据
  - 确保一致性
  - 高资源消耗
  - 初始化使用
```

---

## 📊 集成监控

### 监控指标
```yaml
性能指标:
  - API 调用次数
  - 响应时间
  - 错误率
  - 速率限制使用

业务指标:
  - 同步成功率
  - 数据延迟
  - 数据量
  - 异常数量

系统指标:
  - CPU 使用率
  - 内存使用
  - 网络流量
  - 磁盘 I/O
```

### 告警配置
```yaml
告警规则:
  API 错误:
    - 条件: 错误率 > 5%
    - 级别: 高
    - 通知: 即时

  同步延迟:
    - 条件: 延迟 > 5分钟
    - 级别: 中
    - 通知: 15分钟

  数据不一致:
    - 条件: 数据校验失败
    - 级别: 高
    - 通知: 即时

通知方式:
  - 邮件
  - 短信
  - Slack/钉钉
  - PagerDuty
```

---

## 🔗 相关 Skills

- `/multi-store-manager` - 多店铺 API 集成
- `/order-automation` - 订单自动化集成
- `/inventory-optimizer` - 库存系统集成
- `/workflow-automation` - 工作流集成
- `/customer-profile-builder` - CRM 集成

---

## 📊 成功指标

### 技术指标
- API 成功率 > 99.5%
- 平均响应时间 < 500ms
- 数据延迟 < 30秒

### 业务指标
- 数据准确率 > 99.9%
- 同步覆盖率 = 100%
- 异常恢复时间 < 1小时

---

## ⚠️ 注意事项

### 常见错误
- 忽视速率限制
- 错误处理不足
- 数据验证缺失
- 监控告警缺失

### 最佳实践
- 幂等性设计
- 完整的错误处理
- 充分的日志记录
- 定期的数据校验

---

**Connect everything, automate anything! 🔗**

**版本**: 1.0.0
**更新**: 2026-04-12
**作者**: Shopilot Team