SuperAPI AI 工具集

shopify-setup

部署与运维

查看项目

更新于 10-15 23:31

技能介绍

用途:为 Shopify 商店搭建可用的 Shopify CLI 认证与 Admin API 访问,产出经过验证、可用于商品与内容管理的 API 连接。

主要能力与流程:

  1. 检查前置条件,运行 shopify version 确认 CLI 是否安装;未安装则执行 npm install -g @shopify/cli。
  2. 登录商店:shopify auth login --store mystore.myshopify.com,通过浏览器 OAuth 授权,用户需为店主或具备相应权限的员工;随后用 shopify store info 验证。
  3. 创建自定义应用以获取稳定的 Admin API 访问令牌(CLI 会话令牌会过期)。若已有应用可跳过。创建路径为 https://{store}.myshopify.com/admin/settings/apps/development,点击 Create an app、命名、配置 Admin API scopes,启用 read_products、write_products、read_content、write_content、read_product_listings、read_inventory、write_inventory、read_files、write_files,保存并安装后复制仅显示一次的 Admin API access token。
  4. 安全保存令牌:项目内可创建 .dev.vars,写入 SHOPIFY_STORE 与 SHOPIFY_ACCESS_TOKEN,并确保 .dev.vars 加入 .gitignore;跨项目使用可存入环境变量或密钥管理器。
  5. 验证访问:用 curl 向 https://{store}.myshopify.com/admin/api/2025-01/graphql.json 发送 GraphQL 查询,请求头带 X-Shopify-Access-Token,预期返回商店名称与域名;401 表示令牌无效或过期,需重建应用。
  6. 保存配置:在项目根目录创建 shopify.config.json,包含 store、apiVersion、tokenSource 字段。

关键模式:始终指定明确的 API 版本(如 2025-01),避免在生产使用 unstable;令牌类型中 Admin API access token 为 shpat_* 前缀、稳定长期有效,CLI 会话令牌短时有效仅用于 CLI 命令,Storefront API token 为 shpca_* 用于公开店面查询,本技能配置的是 Admin API 访问令牌。速率限制方面,REST 为突发 40 请求/秒、持续 2 请求/秒,GraphQL 为每秒 1000 成本点、单次查询上限 2000 点,批量操作应使用 bulkOperationRunQuery 而非循环。

限制:资料未提供具体收费、价格、平台兼容范围及更多使用步骤,相关细节暂未提供。