用途：通过 curl 直接操作 Shopify 店铺，覆盖商品、库存、订单、客户、元字段等管理任务，无需 SDK 或应用框架，只需 GraphQL 端点与自定义应用访问令牌。REST Admin API 自 2024-04 起为遗留接口，仅接收安全修复，管理操作应使用 GraphQL Admin，面向客户端的只读查询使用 Storefront GraphQL。
主要能力：查询与创建商品及变体、更新价格与 SKU、按条件搜索商品；读取与调整库存（增量 inventoryAdjustQuantities、绝对值 inventorySetQuantities）；列出与查询订单、客户；读写 metafields 与 metaobjects；通过 Bulk Operations 导出大批量数据；订阅 Webhook 事件。
使用方式：在 Shopify 后台创建应用并配置 Admin API 权限范围，安装后获取仅显示一次的访问令牌（以 shpat_ 开头），写入 ${HERMES_HOME:-~/.hermes}/.env 中的 SHOPIFY_ACCESS_TOKEN、SHOPIFY_STORE_DOMAIN、SHOPIFY_API_VERSION。请求端点为 https://$SHOPIFY_STORE_DOMAIN/admin/api/$SHOPIFY_API_VERSION/graphql.json，认证头为 X-Shopify-Access-Token，方法固定 POST，Content-Type 为 application/json，请求体为 {"query": "...", "variables": {...}}。ID 为 GID 字符串，需原样传递。
限制与注意：HTTP 200 不代表成功，需同时检查顶层 errors 与 userErrors；速率限制按查询成本计算，标准店铺为 100 点桶、50/s 恢复，Plus 为 1000/100；无 read_all_orders 时订单默认仅返回最近 30 条且受 60 天窗口限制；金额为字符串；多币种需区分 shopMoney 与 presentmentMoney。变更操作会真实影响店铺数据，执行删除、取消订单、退款等前需向用户确认。2026-01-01 后新建应用应使用 Dev Dashboard，已有后台创建的应用继续可用。