用途:为 Saleor 无头电商平台提供开发与集成支持,覆盖 GraphQL API 构建调试、Webhook 事件响应、Saleor App 与仪表盘扩展开发、自托管与 Saleor Cloud 选型,以及结账/转化问题。
主要能力与工作原理:Saleor 是 BSD-3 开源、基于 Python/Django 的 GraphQL 优先无头电商平台,只有一个 GraphQL 端点,没有 REST。Cloud 地址为 https://{your-store}.saleor.cloud/graphql/,自托管为 http://localhost:8000/graphql/。公开商品读取无需令牌,变更操作需要令牌。
认证:用户用 tokenCreate(email, password) 获取短期 JWT 和刷新令牌(RS256 签名),用 tokenRefresh 刷新;App 在安装或创建时获长期令牌用于机器间通信。均以 Authorization: Bearer <token> 或 Authorization: JWT <token> 发送,可通过 /.well-known/jwks.json 或 tokenVerify 校验。
结账流程:以变体 ID(非商品 ID,变体承载库存与价格)和渠道调用 checkoutCreate,再经邮箱、收货/账单地址、配送方式、支付/交易步骤,最后 orderCreateFromCheckout(需 App 令牌)转订单,再 orderMarkAsPaid。
Webhook:支持原生出站 Webhook,需注册到 App,区分同步(阻塞请求,如税费、配送、支付)与异步(请求后触发,如 ORDER_CREATED),载荷由 GraphQL 订阅定义。默认使用 JWS RS256(分离载荷)签名,通过 JWKS 公钥校验;HMAC SHA-256 已弃用,仅当设置 secretKey 时使用。必须对原始请求体校验,不能对重新序列化的对象校验。同步 Webhook 有约 20 秒总往返上限(2 秒连接 + 18 秒响应)。
适用场景:GraphQL 集成、电商事件自动化、App 开发、自托管或 Cloud 部署选型。
限制:自托管免费,Saleor Cloud 沙箱免费但非商用,商用 Select 约 $1,599/月,其余档位与价格暂未提供。Saleor 不是 Merchant of Record,税费/增值税合规由用户负责,需接入税务应用。saleor-platform 仓库仅用于开发,生产需 Postgres、Redis(Celery worker 与 beat)和 Core Dockerfile,并正确设置 ALLOWED_HOSTS。资料为 2026-06 研究,计划门槛、费用、认证、Webhook 签名行为与 API 形状需以实时文档为准。