跳到主要内容

第三方授权token登录

POST 
/auth/v1/signin/with/provider

接口说明​

通过第三方授权信息生成的provider_token进行登录，支持自动注册新用户或绑定到现有用户

入参要求：​

  • client_id: 应用对应的客户端id（可选，默认为环境id）
  • x-device-id: 设备id（必填，请求头中传入）
  • 请求体参数（v1SignInWithProviderRequest）：
    • provider_token: provider_token（必填，通过获取三方授权信息接口获取）
    • force_disable_sign_up: 强制关闭自动注册（可选，默认false）
    • sync_profile: 是否强制从第三方同步昵称等信息（可选，默认false）

前置条件：​

  • 需要先调用获取三方授权信息接口获取有效的provider_token
  • provider_token必须在有效期内（默认1小时）
  • 第三方身份源需要在云开发平台配置并启用

出参：​

  • 返回标准的token响应（access_token、refresh_token等）
  • 如果用户不存在且自动注册开启，会自动创建新用户
  • 如果用户已存在，会绑定第三方身份源到现有用户

第三方授权token登录请求示例​

POST /auth/v1/signin/with/provider
x-device-id: device_123456
Content-Type: application/json

{
  "provider_token": "your_provider_token",
  "force_disable_sign_up": false,
  "sync_profile": true
}

第三方授权token登录响应示例​

{
  "token_type": "Bearer",
  "access_token": "your_access_token",
  "refresh_token": "m.aB3cD4eF5gH6iJ7kL8mN9oP0qR1sT2uV3wX4yZ5aB6cD7eF8gH9iJ0kL1mN2oP3qR4sT5uV6wX7yZ8",
  "expires_in": 7200,
  "scope": "user sso",
  "sub": "9876543210123456789"
}

使用流程：​

  1. 用户完成第三方授权，获取授权码（code）
  2. 调用获取三方授权信息接口换取provider_token
  3. 调用此接口使用provider_token进行登录
  4. 返回标准的access_token和refresh_token

关键特性：​

  • 支持自动注册新用户（如果force_disable_sign_up为false）
  • 支持绑定到现有用户账号
  • 可以强制同步第三方用户信息到本地账号
  • 支持多种第三方身份源（GitHub、微信、Google等）

注意事项：​

  • provider_token有效期较短，建议及时使用
  • 如果用户已存在，会自动绑定第三方身份源
  • 自动注册功能可以在云开发平台配置是否开启
  • 同步用户信息功能可以更新本地用户的昵称、头像等信息

Request​

Responses​

A successful response.

Response Headers