API 参考

OAuth

用于第三方登录方式认证的 OAuth 2.0 / PKCE 流程端点。SDK 会自动处理这些流程 — 此处文档供自定义实现参考。

支持的登录方式

google
github
apple
kakao
naver
facebook
discord
x
slack
twitch
line
microsoft

OAuth 流程

1
发起 OAuth
调用授权端点获取带 PKCE 挑战的 OAuth URL。
2
重定向用户
将用户重定向到 OAuth 登录方式的授权页面。
3
处理回调
登录方式将携带授权码重定向回您的回调 URL。
4
换取令牌
使用授权码换取 Authon 访问令牌和刷新令牌。
GET/v1/oauth/:provider/authorize

获取授权 URL

获取带 PKCE 挑战的 OAuth 登录方式授权 URL。返回用于重定向用户的 URL。

查询参数
text
?projectId=proj_abc123&redirectUrl=https://yourapp.com/callback
响应
json
{
  "url": "https:0
  2: "random_state_value",
  "codeVerifier": "pkce_verifier"
}
POST/v1/oauth/:provider/callback

处理 OAuth 回调

将 OAuth 授权码换取 Authon 令牌。

请求体
json
{
  "code": "auth_code_from_provider",
  "state": "random_state_value",
  "codeVerifier": "pkce_verifier",
  "projectId": "proj_abc123"
}
响应
json
{
  "accessToken": "eyJhbGci...",
  "refreshToken": "rt_abc123...",
  "expiresIn": 3600,
  "user": {
    "id": "usr_abc123",
    "email": "user@example.com",
    "displayName": "John Doe"
  },
  "isNewUser": false
}
Authon — Universal Authentication Platform