Platform admin

Shopgation

Sign in as a platform admin to list every store and merchant. Store-owner catalog and orders stay scoped to one tenant.

Traditional Chinese is the default. You can switch to English or Simplified Chinese.

The HTTP contract is docs/openapi.yaml.

Platform admin

These routes require the platform admin session. They read across tenants on purpose.

• POST/api/platform/auth/registerBootstrap platform admin
• POST/api/platform/auth/loginPlatform admin sign-in
• POST/api/platform/auth/logoutPlatform admin sign-out
• GET/api/platform/auth/meCurrent platform admin
• GET/api/platform/tenants?q=Search and list stores
• POST/api/platform/tenantsCreate a store
• PATCH/api/platform/tenants/{id}Update store details
• GET/api/platform/tenants/{id}/accountStore owner account
• POST/api/platform/tenants/{id}/account/inviteSend owner invite (not delivered)
• POST/api/platform/tenants/{id}/account/reset-passwordReset owner password (not delivered)
• POST/api/platform/tenants/{id}/impersonateStart impersonation for a store
• GET/api/platform/impersonationCurrent impersonation
• POST/api/platform/impersonation/endEnd impersonation
• GET/api/platform/impersonationsImpersonation audit log
• GET/api/platform/merchantsAll merchants
• GET/api/platform/settingsPlatform settings

Stores

Store owner routes stay available. Each call is limited to that owner's tenant.

• POST/api/auth/registerRegister a store
• POST/api/auth/loginSign in
• POST/api/auth/logoutSign out
• GET/api/auth/meCurrent store owner
• GET/api/categoriesCategories
• GET/api/productsProducts
• GET/api/ordersOrders
• PATCH/api/orders/{id}Update order status and notes
• GET/api/settingsStore settings

Storefront

Public catalog reads use the store slug. Only published products are returned.

• GET/api/storefront/{slug}/productsPublished products for a store
• GET/api/storefront/{slug}/products/{productSlug}One published product

Checkout

Guest cart and checkout use the store slug. Payment is a stub and does not charge.

• GET/api/cart?slug=Guest cart
• POST/api/cart/itemsAdd to cart
• PATCH/api/cart/items/{id}Update a cart line
• POST/api/checkoutPlace order (no charge)