网站交付模式与无头API
您的公共网站可以来自内置商店,单独部署的前端(例如Next.js应用或移动应用),或两者兼有。选择在一个管理界面中进行,改变它无需重新部署.
设置位置
网站构建器 → 网站交付 (/admin/storefront/headless). 该界面显示当前模式、前端地址、可达性检查以及上次缓存刷新发送到前端的时间.
五种模式
| 模式 | 公共网站 | 何时使用它 |
|---|---|---|
| 仅内置网站 | 此应用 | 大多数商店。一个服务器,无需额外部署. |
| 内置和单独前端 | 两者兼有 | 您正在尝试一个新的前端,而当前网站仍在销售。客户邮件链接到客户使用的网站. |
| 内置页面,前端购物 | 主页、页面和博客在这里;购物、购物车、结账和账户在前端. | 您的内容团队保持页面构建器,而商店转移到更快的前端. |
| 仅单独前端 | 前端 | 前端是整个公共网站。此主机将访客重定向到那里,仅保留管理面板和API,隐藏于搜索引擎. |
| 网站关闭 | 无 | 没有目录的后台,例如仅运行ERP的制造商。 |
每个重定向、生成的链接和客户电子邮件——密码重置、验证、订单、购物车恢复——都遵循您选择的模式。
店面API
- 基本地址:
/api/storefront/v1. 在您选择使用前端的模式之前,它是关闭的。 - 参考:
/api/storefront/v1/docs(OpenAPI)。它对管理员可见;您可以在同一屏幕上将其公开。 - 涵盖网站、主题、页面、菜单、头部和底部、表单、目录、购物车、结账、登录和客户门户。可选模块如博客、评论、预订和忠诚度仅在安装后回答。
- 每个列表端点都是分页的(默认每页24个,最多60个)。
安全切换到单独的前端
- 部署前端并记录其HTTPS地址。
- 选择 内置和单独前端 首先,输入前端地址并保存。两个站点现在都可以工作。
- 在前端测试浏览、购物车、结账和登录。
- 为任何形状变化的旧链接添加重定向,每行一个。
- 只有在那之后切换到 仅单独前端 或页面/商店拆分。
- 如果您使用Cloudflare,请添加区域ID和清除令牌,以便在每次内容更改后清除前端缓存。
最后更新:11/7/2026

