NATSidentity.user.link-third-party绑定三方身份

Try it 面板需要启用 JavaScript。

将三方身份绑定到用户；提供方侧的授权码校验由调用方（api_service / openapi）完成后传入三方账号标识。

Request Payload

消息格式：JSON

Name	Data Type	Required	Description
userId	string	Yes	用户 ID
provider	string	Yes	提供方：google / apple / github
providerAccountId	string	Yes	提供方账号唯一标识

type RequestBody = {
  /** 用户 ID */
  userId: string
  /** 提供方：google / apple / github */
  provider: string
  /** 提供方账号唯一标识 */
  providerAccountId: string
}

{
  "userId": "01JD8SEGQ0P9N2XK4L7VDH3T6C",
  "provider": "google",
  "providerAccountId": "g_518329"
}

Response Payload

回复使用统一信封 {id, code, messages, result}，其 result：

Name	Data Type	Required	Description
linkId	string	Yes	绑定关系 ID
linkedAt	string	Yes	绑定时间

type ResponseBody = {
  /** 绑定关系 ID */
  linkId: string
  /** 绑定时间 */
  linkedAt: string
}

{
  "linkId": "01JD8SF02Q5N9W3XL7R0WDI4U6C",
  "linkedAt": "2026-10-14T10:00:00Z"
}

Response Code

回复使用统一信封 {id, code, messages, result}，其 code 字段：

code	Meaning	Notes
0	成功	绑定三方身份
2011	已绑定该三方
2012	三方账号已被他人绑定

Examples

{
  "userId": "01JD8SEGQ0P9N2XK4L7VDH3T6C",
  "provider": "google",
  "providerAccountId": "g_518329"
}

{
  "id": "01JD8SUU8N0Z6B3CY",
  "code": 0,
  "messages": [],
  "result": { "linkId": "01JD8SF02Q5N9W3XL7R0WDI4U6C", "linkedAt": "2026-10-14T10:00:00Z" }
}