SuperAPI AI 工具集

app-shopify-admin-graphql

编程与开发

查看项目

更新于 10-16 01:37

技能介绍

用途:当你在 Shopify Remix 应用中添加或修改与 Shopify Admin API 的 GraphQL 通信代码时使用本技能,可查询店铺、客户、订单、商品、库存等数据,也可创建或更新客户、订单、商品,并处理大数据集分页、API 限流与元字段等资源。

主要能力与用法: 一、获取 GraphQL 客户端。在 Remix loader/action 中推荐使用 @shopify/shopify-app-remix 的 authenticate.admin(): import { authenticate } from "../shopify.server"; 在后台任务或 webhook(无请求上下文)中使用 offline 会话:import { unauthenticated } from "../shopify.server"; 二、查询与变更。使用 admin.graphql(query, { variables }) 并 await response.json() 获取 data。变量查询时资料示例对 email 做了格式校验与引号转义,防止查询被篡改。 三、常见查询模式。资料给出店铺详情、商品分页(使用 pageInfo 的 hasNextPage 与 endCursor)、按 query 查客户、按 ID 查订单(含 totalPriceSet、lineItems、shippingAddress)等示例。 四、限流与错误。Shopify 采用漏桶算法限流;资料提供带指数退避的 executeWithRetry 逻辑,检测 errors 中 extensions.code 为 THROTTLED 时重试。错误处理需检查 errors 数组,判断 THROTTLED 或 not found 等情形。

适用场景:需要在 Remix 应用内与 Shopify Admin API 交互、做分页拉取、后台任务与 webhook 数据处理、以及需要限流重试保障的场合。

限制与最佳实践:为操作命名便于调试;只请求需要的字段;列表必须分页,不要请求无界数据;用 fragment 复用重复字段;复杂关联查询优先用 GraphQL 而非 REST;后台任务实现指数退避重试。资料未提供具体定价、平台支持范围与其他未提及信息。