平台管理

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結帳（不扣款）