API 参考

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

• API 来源提交: 5912605d35f2384bd6bbd4b868b87afeedac6a96
• OpenAPI SHA-256: c7bd778d077f80f71ece290839a6b984aeef824c2a774510e882a617afecd644
• 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 — 读取安装级凭据就绪与阻塞事实

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。

权威阻塞原因

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