Open Skills Logo
Open Skills

shopify-apps

Shopify应用开发的专家模式涵盖：Remix/React Router应用框架、基于App Bridge的嵌入式应用、Webhook处理机制、GraphQL Admin API集成、Polaris组件库、计费系统配置以及应用扩展模块。适用场景：Shopify应用开发、嵌入式应用构建、Polaris设计系统实施、App Bridge交互对接。

作者

@sickn33

分类

开发工具

安装

热度:17

下载并解压到你的 skills 目录

复制命令，发送给 OpenClaw 自动安装：

下载并安装这个技能 https://openskills.cc/api/download?slug=sickn33-skills-shopify-apps&locale=zh&source=copy

Shopify Apps - Shopify 应用开发专家模式

技能概述


Shopify Apps 提供经过实战验证的 Shopify 应用开发模式，涵盖基于 React Router 的嵌入式应用开发、App Bridge 集成、Webhook 安全处理、GraphQL Admin API 调用、Polaris 组件使用以及计费和扩展功能实现。

适用场景

  • 开发 Shopify 嵌入式应用

    • 当你需要构建在 Shopify Admin 后台中运行的应用时，使用此模式可以正确实现 App Bridge 集成，确保应用能够安全、无缝地嵌入 Shopify 管理界面。

  • 处理 Shopify Webhook 事件

    • 当需要接收和处理 Shopify 的事件通知（如订单创建、产品更新等）时，此模式提供了 HMAC 验证的安全实现方案以及异步处理的最佳实践。

  • 使用 GraphQL 构建 API 集成

    • 当开发新的 Shopify 应用时，此模式推荐使用 GraphQL Admin API 而非 REST API，以获得更好的性能、更精确的数据查询和更强的类型安全。

    核心功能

  • React Router 应用架构

    • 提供现代化的 Shopify 应用模板配置，支持 React Router 路由管理，确保应用结构与 Shopify 生态系统的最佳实践保持一致。

  • App Bridge 嵌入集成

    • 实现 App Bridge 集成，使应用能够正确渲染在 Shopify Admin 中，处理身份验证、跨域通信和 UI 一致性，包括通过 script tag 使用最新版本的 App Bridge。

  • Webhook 安全处理

    • 提供带 HMAC 验证的安全 webhook 处理模式，确保请求来源可信，并采用"立即响应、异步处理"的策略避免超时问题，同时检查速率限制头部。

    常见问题

    开发 Shopify 应用应该用 REST 还是 GraphQL API？

    对于新项目，强烈建议使用 GraphQL Admin API。GraphQL 提供更精确的数据查询能力、更好的性能表现以及更强的类型安全。REST API 主要用于维护现有项目或特定场景的兼容性需求。

    Shopify webhook 如何进行安全验证？

    所有 webhook 请求都必须进行 HMAC 验证以确保请求来自 Shopify。验证过程需要使用应用的 API 密钥对请求体进行 HMAC 计算，并与请求头中的签名进行比对。此外，处理 webhook 时应立即返回响应，然后将实际处理逻辑放入异步队列中执行。

    如何处理 Shopify API 的速率限制？

    每次 API 调用后都应该检查响应头中的速率限制信息（如 X-Shopify-Shop-Api-Call-Limit）。当接近限制时，应该实现退避策略。对于需要大量数据操作的场景，优先使用 bulk operations 或考虑请求受保护的客户数据访问。