用途:这是一个 Shopify 平台帮助技能,用于解答与 Shopify 相关的开发与运营问题,包括 API/Webhook 集成、套餐选择、结账与转化问题、店铺运营任务。
主要能力:先收集上下文,判断用户目标是构建或调试集成、选套餐、结账转化还是店铺运营;确认使用面(GraphQL Admin API、旧版 REST Admin API、Storefront API、Webhook 或无代码后台);区分自定义应用与公开应用;确认套餐(Basic、Grow、Advanced、Plus,部分功能如 Checkout Extensibility、更高 API 限额、B2B 为 Plus 专属)。若问题属于跨平台策略,会转交到对应技能,例如结账转化转 /sales-checkout、全球税务转 /sales-merchant-of-record、数字产品定价转 /sales-digital-products、iPaaS 集成转 /sales-integration、购后邮件转 /sales-email-marketing。
使用方式:读取 references/platform-guide.md 获取完整参考,读取 references/shopify-api-reference.md 获取端点、认证、限流与 Webhook 细节;只引用相关章节作答。建议基于 GraphQL 构建,REST Admin API 自 2024-10-01 起为旧版,2025-04-01 起新公开应用必须仅用 GraphQL。每个 Webhook 都需验证:对原始请求体用应用 API secret 计算 HMAC-SHA256,base64 编码后与 X-Shopify-Hmac-Sha256 做时序安全比较;三个强制 GDPR 合规 Webhook 必须通过验证。Webhook 仅作提示,需按 updated_at 或 X-Shopify-Triggered-At 与 API 对账。GraphQL 按成本限流,需关注 extensions.cost.throttleStatus,遇 THROTTLED 退避,大批量导出用 bulk operations。
适用场景:Webhook 签名验证失败排查、订单同步到数据仓库、套餐选择与费用权衡等。
限制:资料基于 2026-06 研究,套餐门槛、费用与当前 API 版本需以实时文档为准;REST 端点仍可用但已冻结;checkout.liquid 定制与附加脚本已弃用;使用第三方支付网关时会在卡费率之上产生交易费;API 访问范围须在安装时申请,缺失范围会返回拒绝访问错误而非空数据。若发现未记录的问题,可按日期追加到 references/learnings.md。