平台管理

Shopgation

以平台管理员登录，即可列出所有商店与商家。店主的商品与订单仍只限自己的商店。

默认语言为繁体中文。你可以切换到英文或简体中文。

HTTP 契约在 docs/openapi.yaml。

平台管理

这些路由需要平台管理员会话，并故意跨租户读取。

• POST/api/platform/auth/register创建首位平台管理员
• POST/api/platform/auth/login平台管理员登录
• POST/api/platform/auth/logout平台管理员登出
• GET/api/platform/auth/me当前平台管理员
• GET/api/platform/tenants?q=搜索并列出商店
• POST/api/platform/tenants创建商店
• PATCH/api/platform/tenants/{id}更新商店资料
• GET/api/platform/tenants/{id}/account店主账号
• POST/api/platform/tenants/{id}/account/invite发送邀请（未寄出）
• POST/api/platform/tenants/{id}/account/reset-password重置密码（未寄出）
• POST/api/platform/tenants/{id}/impersonate代登指定商店
• GET/api/platform/impersonation当前代登
• POST/api/platform/impersonation/end结束代登
• GET/api/platform/impersonations代登审计记录
• GET/api/platform/merchants所有商家
• GET/api/platform/settings平台设置

商店

店主路由仍然可用。每次调用只限该店主的商店。

• POST/api/auth/register开店注册
• POST/api/auth/login登录
• POST/api/auth/logout登出
• GET/api/auth/me当前店主
• GET/api/categories分类
• GET/api/products商品
• GET/api/orders订单
• PATCH/api/orders/{id}更新订单状态和备注
• GET/api/settings商店设置

店面

公开店面用短名读取商品。只返回已上架商品。

• GET/api/storefront/{slug}/products店面已上架商品
• GET/api/storefront/{slug}/products/{productSlug}一件已上架商品

结账

访客购物车和结账用短名指定商店。付款是未扣款的占位。

• GET/api/cart?slug=访客购物车
• POST/api/cart/items加入购物车
• PATCH/api/cart/items/{id}更新购物车项目
• POST/api/checkout结账（不扣款）