SuperAPI AI 工具集

api-graphql

编程与开发

查看项目

更新于 10-15 21:12

技能介绍

用途:与 Shopify GraphQL API 交互,包括 Admin API(完整店铺访问,仅后端,需 OAuth 或 API key 认证)与 Storefront API(公开店铺前台访问,使用公开访问令牌,可安全用于前端或客户端)。适用于查询 Shopify 数据(商品、订单、客户)、通过 mutation 创建或更新资源、构建店铺集成、处理元字段与元对象、处理 API 分页、管理认证与限流。

主要能力:提供商品、订单、客户、集合、库存的常见查询示例;提供创建/更新商品、创建草稿订单、调整库存等 mutation 示例;支持元字段读写及类型说明;演示基于游标的分页;说明查询成本与限流状态字段,并给出带重试的限流处理示例;支持 Storefront 认证、商品查询与购物车操作;支持 Webhook 订阅及主题列表;支持批量操作查询与状态轮询。

使用方式:Admin API 使用 @shopify/shopify-api 初始化(需 apiKey、apiSecretKey、scopes、hostName、apiVersion),在应用路由中通过 authenticate.admin 发起 admin.graphql 查询。Storefront 使用 StorefrontApiClient,配置 privateAccessToken、storeDomain、apiVersion。请求仅取所需字段,使用片段复用字段,mutation 中检查 userErrors,实现分页,监控限流,大批量导出使用批量操作。

限制:Admin API 仅限后端,不可用于客户端;Storefront API 使用公开访问令牌;需注意查询成本与恢复速率触发的 THROTTLED 限流,并实现退避重试;所有事实以 API 参考文档为准,本技能未提供具体价格或收费信息。