第三方店铺前端公共 API

当前 artifact 包含 14 项 Storefront 公开 operation。下列链接与通用 API Reference 使用同一批生成页；未列出路径的资源均尚未开放。

• API 来源提交: 5912605d35f2384bd6bbd4b868b87afeedac6a96
• OpenAPI SHA-256: c7bd778d077f80f71ece290839a6b984aeef824c2a774510e882a617afecd644

托管跳转边界

目录读取留在第三方站。登录/注册与结账/支付未来只能顶层跳转到 Ayalink 官方托管页面，再返回平台审核的精确 return URL；当前两类托管能力均未进入 artifact，本站不提供 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 — 按语言读取当前已发布法律正文

尚未开放的资源组

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

• 托管登录与注册 — 尚未开放
• 托管结账与支付 — 尚未开放
• SKU 与库存可售 — 尚未开放
• 独立价格资源 — 尚未开放
• locale 与 fallback — 尚未开放
• 媒体资源 — 尚未开放

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