SuperAPI AI 工具集

shopify-known-pitfalls

编程与开发

查看项目

更新于 10-15 23:29

技能介绍

用途:这是一个面向 Shopify 应用开发/审计的检查清单类技能,帮助识别并规避 10 个常见 API 反模式,每个条目配有错误写法与正确写法对比。

主要能力:覆盖不检查 userErrors、在需用 GraphQL 时误用 REST、忽略 API 版本弃用、缺少强制 GDPR Webhook(customers/data_request、customers/redact、shop/redact)、Webhook 处理超时、在 2024-10+ 误用 ProductInput、未使用游标分页、一次性请求 250 条、把 Admin Token 暴露到客户端、未处理 APP_UNINSTALLED 等问题;并提供检测方式与预防措施(ESLint、CI 检查、队列处理等)。

使用方式:需已有 Shopify 应用代码可供审查;熟悉 GraphQL Admin API 查询结构与响应;已配置所需访问范围;代码示例基于 @shopify/shopify-api v9+。可用脚本扫描 REST 使用、缺失 userErrors 检查、旧 API 版本、硬编码令牌与超大分页请求。版本方面建议使用 LATEST_API_VERSION 并关注 x-shopify-api-deprecated-reason 响应头。

适用场景:发布前自查、App Store 合规检查、遗留代码迁移与安全审计。

限制:资料仅给出条目与示例方向,未提供完整代码、具体脚本内容、价格与平台细节;具体实现需结合官方文档。