API 参考

当前目录包含 25 个由 API CI 明确发布的 public-only 操作：14 个 Storefront 公开读取、2 个 installation 身份/readiness 读取、5 个 hosted 后端 session 基础操作和 4 个 API Key 目录读取。未列出的路由均视为私有。

• API 来源提交: 2d63ab5caa6d65c1ea9fe253c5bdfbec77b2a170
• OpenAPI SHA-256: 33f52714521cbd7573bcc808c38dd8dc189d7bafa2fd3a6d4c914b70853357b2
• OpenAPI: 3.1.0

Storefront 公开读取

• GET /api/v1/runtime-config — 读取公开运行配置
• GET /api/v1/bootstrap — 读取公开站点启动配置
• GET /api/v1/public/contact — 读取公开联系渠道
• GET /api/v1/legal/documents — 按语言读取当前已发布法律正文
• GET /api/v1/storefront-decorations/merchants/{slug} — 读取店铺已发布装修
• GET /api/v1/public/store-access/{store}/config — 读取店铺公开安全配置
• GET /api/v1/search — 搜索可公开销售商品
• GET /api/v1/catalog/categories — 读取公开分类
• GET /api/v1/catalog/products — 读取公开商品目录
• GET /api/v1/catalog/products/{slug} — 按 slug 读取公开商品
• GET /api/v1/catalog/merchants/{slug} — 读取公开店铺资料
• GET /api/v1/catalog/merchants/{slug}/products — 读取店铺公开商品
• GET /api/v1/catalog/merchants/{slug}/categories — 读取店铺公开分类
• GET /api/v1/catalog/merchants/{merchantSlug}/products/{productSlug} — 读取店铺公开商品详情

Installation 身份与 readiness

• GET /api/v1/open/installation/identity — 读取安装级凭据绑定身份
• GET /api/v1/open/installation/readiness — 读取安装级凭据就绪与阻塞事实

Hosted 后端 session 基础

• POST /api/v1/open/hosted/login/initiate — 创建官方托管登录流程
• POST /api/v1/open/hosted/login/return — 以 PKCE 单次消费托管登录返回码
• POST /api/v1/open/hosted/checkout/sessions — 创建服务端重算的托管结账会话
• GET /api/v1/open/hosted/checkout/sessions/{sessionId} — 读取绑定安装的托管结账状态
• POST /api/v1/open/hosted/checkout/sessions/{sessionId}/cancel — 取消尚未进入不可逆支付阶段的托管结账

API Key 目录读取

• GET /api/v1/open/identity — 读取当前 API Key 的标识与 scope
• GET /api/v1/open/catalog/categories — 通过 API Key 读取公开分类
• GET /api/v1/open/catalog/products — 通过 API Key 读取公开商品目录
• GET /api/v1/open/catalog/products/{slug} — 通过 API Key 读取公开商品

未开放能力

OAuth、Turnstile、installation 写入与 Webhook 管理不在本 artifact 中，本站不生成这些 endpoint。Hosted 操作仅提供后端 session 安全基础；官方 UI、订单最终创建、Provider 支付推进、生产配置与迁移尚未完成，不得据此认定支付可用。

权威阻塞原因

以下状态来自同一 public-only artifact，只解释能力为何尚未开放，不表示 endpoint 已存在。