القائمة
يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.
اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.
npx skills add https://github.com/huifer/Shopilot --skill api-integratorيبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.
تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.
استنادا إلى تصنيف SOC المهني
عرض SKILL.md
| name | api-integrator |
| description | API 集成连接器 - 指导电商 API 集成，包括 Shopify API、ERP/CRM 集成和 Webhook 配置 |
| version | 1.0.0 |
| author | Shopilot |
| argument-hint | <integration-type> [target-system] |
| disable-model-invocation | false |
| user-invocable | true |
连接你的电商生态系统
API 集成连接器帮助电商商家实现系统间的无缝连接，从 Shopify API 集成到第三方 ERP/CRM 连接，提供完整的 API 集成指南和最佳实践。
目标系统:
SAP:
- 复杂度: 高
- 适合: 大型企业
- 成本: $[50,000-200,000]
Oracle NetSuite:
- 复杂度: 高
- 适合: 中大型企业
- 成本: $[25,000-100,000]
Microsoft Dynamics:
- 复杂度: 中高
- 适合: 中型企业
- 成本: $[20,000-80,000]
Odoo:
- 复杂度: 中
- 适合: 中小企业
- 成本: $[5,000-30,000]
集成功能:
- 订单同步
- 库存管理
- 产品信息
- 财务数据
- 客户信息
目标系统:
Salesforce:
- 复杂度: 中高
- 适合: 中大型企业
- 成本: $[10,000-50,000]
HubSpot:
- 复杂度: 中
- 适合: 中小企业
- 成本: $[5,000-20,000]
Microsoft Dynamics 365:
- 复杂度: 中高
- 适合: 中大型企业
- 成本: $[15,000-60,000]
集成功能:
- 客户数据同步
- 订单历史
- 营销自动化
- 客户服务
- 销售管道
目标系统:
QuickBooks:
- 复杂度: 低
- 适合: 小型企业
- 成本: $[2,000-10,000]
Xero:
- 复杂度: 低
- 适合: 小型企业
- 成本: $[2,000-10,000]
Sage:
- 复杂度: 中
- 适合: 中小型企业
- 成本: $[5,000-20,000]
集成功能:
- 订单同步
- 发票生成
- 库存价值
- 财务报表
- 税务计算
认证方式:
API 密钥:
- Admin API
- 用于服务端集成
- 需要 API 密钥和密码
Access Token:
- Admin API
- 用于特定应用
- 更安全的方式
OAuth 2.0:
- 用于公共应用
- 用户授权流程
API 版本:
- REST Admin API
- GraphQL Admin API
- Storefront API
- Liquid (模板)
速率限制:
- 漏桶算法
- 40 请求/秒 (标准)
- 80 请求/秒 (Plus)
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:
- 更高效的数据查询
- 单次请求多个资源
- 类型安全
- 更好的性能
性能优化:
- 批量操作
- 使用 GraphQL
- 缓存数据
- 异步处理
错误处理:
- 重试机制
- 指数退避
- 错误日志
- 监控告警
安全措施:
- 使用 HTTPS
- 验证输入
- 限制权限
- 定期轮换密钥
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. 错误处理和重试
验证签名:
- HMAC-SHA256
- 验证数据完整性
- 防止伪造请求
处理流程:
1. 接收 Webhook
2. 验证签名
3. 解析数据
4. 业务逻辑处理
5. 返回 200 OK
6. 错误时返回非 200
重试机制:
- Shopify 自动重试
- 最多 19 次
- 指数退避
- 最终失败通知
Phase 1: 需求分析
明确需求:
- 集成目标
- 数据流向
- 触发条件
- 业务规则
技术评估:
- API 可用性
- 数据结构
- 限制条件
- 安全要求
Phase 2: 设计
架构设计:
- 系统架构
- 数据流程
- 错误处理
- 监控日志
接口设计:
- API 映射
- 数据转换
- 同步策略
- 事务处理
Phase 3: 开发
开发任务:
- API 客户端开发
- 数据映射
- 业务逻辑
- 错误处理
测试:
- 单元测试
- 集成测试
-
实时同步:
- Webhook 触发
- 低延迟
- 高资源消耗
- 适合关键数据
定时同步:
- 批量处理
- 低资源消耗
- 有延迟
- 适合非实时数据
增量同步:
- 只同步变化
- 高效
- 需要时间戳
- 推荐方式
全量同步:
- 同步全部数据
- 确保一致性
- 高资源消耗
- 初始化使用
性能指标:
- API 调用次数
- 响应时间
- 错误率
- 速率限制使用
业务指标:
- 同步成功率
- 数据延迟
- 数据量
- 异常数量
系统指标:
- CPU 使用率
- 内存使用
- 网络流量
- 磁盘 I/O
告警规则:
API 错误:
- 条件: 错误率 > 5%
- 级别: 高
- 通知: 即时
同步延迟:
- 条件: 延迟 > 5分钟
- 级别: 中
- 通知: 15分钟
数据不一致:
- 条件: 数据校验失败
- 级别: 高
- 通知: 即时
通知方式:
- 邮件
- 短信
- Slack/钉钉
- PagerDuty
/multi-store-manager - 多店铺 API 集成/order-automation - 订单自动化集成/inventory-optimizer - 库存系统集成/workflow-automation - 工作流集成/customer-profile-builder - CRM 集成Connect everything, automate anything! 🔗
版本: 1.0.0 更新: 2026-04-12 作者: Shopilot Team