SuperAPI AI 工具集

saleor-app

通用与其它

查看项目

更新于 10-15 21:04

技能介绍

用途:面向需要扩展 Saleor 的开发者,说明如何构建通过 webhook 和 GraphQL API 与 Saleor 集成的应用。文档为框架无关的协议说明,并给出使用 @saleor/app-sdk 的 Next.js 示例。

主要能力按优先级分为七类:协议(应用 manifest、必需端点、权限、扩展;注册握手、APL、token 作用域、JWT 与签名校验);权限(按功能定义权限,在每个 API 路由校验用户 JWT,基线加逐路由 meta,UI 与服务端一致);支付应用(Transaction API 与提供商 webhook,涉及财务真实性、稳定引用、未知结果、退款与对账);Webhook(异步事件处理、载荷类型、重试策略、签名校验;同步事件处理、响应 schema、性能约束;接收外部服务 webhook 与多租户路由);数据与设置(应用侧 GraphQL 客户端、认证头、代码生成、应用与用户 token;MetadataManager、EncryptedMetadataManager、按域持久化);Dashboard UI(AppBridge iframe 协议、动作、事件、主题与语言同步);开发(常见错误、webhook 试运行、隧道配置、调试清单)。

适用场景:定义应用 manifest 或注册 webhook、处理 Saleor 的异步或同步 webhook 事件、构建支付应用、认证请求、在 Saleor metadata 中存储应用设置、在 iframe 内构建 Dashboard UI、使用应用 token 调用 GraphQL、调试 webhook 失败或认证与权限问题、决定应用可见范围(用户与应用的 scope)。

限制:资料未提供具体安装命令、代码示例细节、收费与价格、平台支持范围或效果数据,暂未提供。