快速开始

如果你负责企业级正式接入，请先按大客户端到端接入指南完成从前置检查到生产与应急的全部门禁。本页只覆盖首个公开读取请求。

选择接入边界

目标	使用	禁止使用
读取公开商品目录	公开 Storefront API	Merchant 会话 Cookie
访问用户账号（开放后）	Authorization Code + PKCE S256，经官方授权域	密码模式、仿冒登录页或共享 Ayalink Cookie
服务端应用	最小 scope 的安装令牌	浏览器保存 client secret
接收业务事件	安装级签名 Webhook	无签名回调或 query token

在 Ayalink Merchant 开发者工作区创建开发者组织、应用版本与店铺安装。文档不代表生产资格：应用版本、scope、法律同意、店铺能力、市场和安装都必须处于有效状态。

配置公开 Base URL

Nuxt 示例只需要公开配置：

NUXT_PUBLIC_AYALINK_API_BASE=https://api.example.invalid/api/v1
NUXT_PUBLIC_AYALINK_AUTH_BASE=https://storefront.example.invalid
NUXT_PUBLIC_AYALINK_CLIENT_ID=replace-with-public-client-id
NUXT_PUBLIC_AYALINK_REDIRECT_URI=https://shop.example.invalid/oauth/callback

以上均为不可用占位值，不是生产地址。禁止给任何秘密加上 NUXT_PUBLIC_。

请求公开数据

const response = await fetch(`${apiBase}/catalog/products`, {
  headers: {
    accept: 'application/json',
    'accept-language': 'zh-CN',
    'x-ayalink-market': 'CN'
  }
})

if (!response.ok) throw new Error(`AYALINK_HTTP_${response.status}`)
const envelope = await response.json()

API 不可用时不得生成假商品。401、403、404、409、422 与 429 必须按错误码与限流分别处理。

信任模型

理解公开文档、平台、店铺、安装、用户与 Provider 的信任边界。