第三方店铺前端公共 API

当前入口包含 14 项 Storefront 公开读取与 5 项 hosted 后端 session 基础操作。下列链接与通用 API Reference 使用同一批生成页；未列出路径的资源均尚未开放。

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

托管跳转边界

目录读取留在第三方站。Artifact 已提供 hosted login initiate/return 与 checkout session create/get/cancel 的后端 API Key session 安全基础，但官方登录/结账 UI、订单最终创建、Provider 支付推进、生产配置与迁移尚未完成，不能视为登录或支付已可用。未来浏览器仍只能顶层跳转到 Ayalink 官方托管页面，再返回平台审核的精确 return URL。第三方不得收集密码/MFA、转发 Ayalink Cookie、处理支付凭据或反代托管页面。

店铺身份与启动配置

• GET /api/v1/runtime-config — 读取公开运行配置
• GET /api/v1/bootstrap — 读取公开站点启动配置
• GET /api/v1/public/contact — 读取公开联系渠道
• GET /api/v1/catalog/merchants/{slug} — 读取公开店铺资料

配置与装修

• GET /api/v1/public/store-access/{store}/config — 读取店铺公开安全配置
• GET /api/v1/storefront-decorations/merchants/{slug} — 读取店铺已发布装修

分类

• GET /api/v1/catalog/categories — 读取公开分类
• GET /api/v1/catalog/merchants/{slug}/categories — 读取店铺公开分类

商品

• GET /api/v1/catalog/products — 读取公开商品目录
• GET /api/v1/catalog/products/{slug} — 按 slug 读取公开商品
• GET /api/v1/catalog/merchants/{slug}/products — 读取店铺公开商品
• GET /api/v1/catalog/merchants/{merchantSlug}/products/{productSlug} — 读取店铺公开商品详情

搜索

• GET /api/v1/search — 搜索可公开销售商品

公开法律内容

• GET /api/v1/legal/documents — 按语言读取当前已发布法律正文

Hosted login 后端 session

• POST /api/v1/open/hosted/login/initiate — 创建官方托管登录流程
• POST /api/v1/open/hosted/login/return — 以 PKCE 单次消费托管登录返回码

Hosted checkout 后端 session

• POST /api/v1/open/hosted/checkout/sessions — 创建服务端重算的托管结账会话
• GET /api/v1/open/hosted/checkout/sessions/{sessionId} — 读取绑定安装的托管结账状态
• POST /api/v1/open/hosted/checkout/sessions/{sessionId}/cancel — 取消尚未进入不可逆支付阶段的托管结账

尚未开放的资源组

当前 artifact 没有以下资源的 operation，因此本站不生成 endpoint、参数、scope 或响应：

• 官方托管登录 UI — 尚未开放
• 官方托管结账 UI 与 Provider 支付推进 — 尚未开放
• 订单最终创建 — 尚未开放
• SKU 与库存可售 — 尚未开放
• 独立价格资源 — 尚未开放
• locale 与 fallback — 尚未开放
• 媒体资源 — 尚未开放

商品 schema 中即使出现价格、媒体或库存相关字段，也不代表存在独立资源 API；只按对应 operation 页的实际 schema 使用。