跳到主要内容

POST /api/public/v1/auth/login

客户登录接口。使用项目级客户端 API Key（Public API Key）和客户标识密码获取访问令牌。

鉴权​

X-Yuzuca-Key: <PUBLIC_API_KEY>
Content-Type: application/json

请求体​

{
  "identifier": { "type": "email", "value": "user@example.com" },
  "password": "secret"
}

accessToken 为访问令牌，用于访问需要登录态的接口；refreshToken 为刷新令牌，用于续期客户会话。

支持使用 username、email、external_user_id 等任意已绑定客户标识登录。

成功响应​

HTTP 状态码 201：

{
  "ok": true,
  "requestId": "req_123",
  "data": {
    "customer": {
      "id": 1,
      "username": "customer_001"
    },
    "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "refreshToken": "k8j2....",
    "accessTokenExpiresAt": "2026-03-21T10:15:00.000Z",
    "refreshTokenExpiresAt": "2026-04-20T10:00:00.000Z"
  }
}

可能错误​

  • 401 INVALID_CREDENTIALS
  • 403 CUSTOMER_DISABLED
  • 401 SIGNATURE_REQUIRED
  • 401 INVALID_SIGNATURE