Admin API 与 GraphQL

国内一个店、美国一个店、还有一个 B2B 站，都接了同一个 ERP。现在库存经常对不上，订单有时候两边都有有时候两边都没有。

从 REST 拿到 `product_id: 8123456789`，塞进 GraphQL 的 `id` 参数直接报错，说格式非法。

用 `productCreate` 带上 `variants` 创建三规格商品，商品建出来了，但变体只剩一个，选项也没了。

一个商品有 300 多个变体，查询 `variants(first: 250)` 只拿到 100 个，没有 `hasNextPage` 提示。

用 `inventoryAdjustQuantities` 做入库，调用一次成功，但库存增加了两倍，重试后变成三倍。

夜间同步任务跑起来后大量 429，加了固定 1 秒重试反而更糟，任务跑不完。

调用时 URL 里没写版本号，最近发现返回字段和半年前不一样，某个字段变成了 null。

同样的 token，读商品正常，写商品就 403，错误里写着 `requires merchant approval for write_products scope`。

发起 `bulkOperationRunQuery` 导出全部订单，轮询了四十分钟还是 `RUNNING`，也没有报错。

要做店铺前台的定制功能（比如会员价），不确定应该走 App Proxy 还是前端直接调接口。

项目里大量用 REST 的 `/products.json`，听说 REST 要被淘汰，不确定迁移优先级。

用新生成的 Admin API token 调 `admin/api/2026-01/products.json`，始终 401，响应体只有 `{"errors":"[API] Invalid…

服务端日志显示请求超时 30 秒，Shopify 侧没有任何记录，怀疑请求根本没出去。

用 `metafieldsSet` 写一个 JSON 类型的字段，一直返回 `INVALID_VALUE`，值看起来是合法的 JSON。

一个商品列表查询正常能跑，加了 `variants` 和 `metafields` 之后开始报 `MAX_COST_EXCEEDED`，但字段看起来不多。

调 `productCreate` 返回 200，但商品没建出来，返回体里 `data.productCreate.product` 是 null。

想把一批高价值顾客打上 `vip` 标签，`customerUpdate` 传 `tags` 后原有标签全被覆盖了。

调用 API 把商品价格改成 99，紧接着收到 `products/update` webhook，payload 里的价格还是 89。

客户下单后要求换一个颜色，后台可以手动改，但 API 里找不到对应的编辑入口。