Referência da API

OAuth

Endpoints do fluxo OAuth 2.0 / PKCE para autenticação de provedores terceiros. O SDK lida com isso automaticamente — estes endpoints estão documentados para implementações personalizadas.

Provedores Suportados

google

github

apple

kakao

naver

facebook

discord

slack

twitch

line

microsoft

Fluxo OAuth

Iniciar OAuth

Chame o endpoint de autorização para obter a URL OAuth com desafio PKCE.

Redirecionar Usuário

Redirecione o usuário para a página de autorização do provedor OAuth.

Tratar Callback

O provedor redireciona de volta para sua URL de callback com um código.

Trocar Código

Troque o código de autorização por tokens de acesso e atualização do Authon.

GET/v1/oauth/:provider/authorize

Obter URL de Autorização

Obtenha a URL de autorização do provedor OAuth com desafio PKCE. Retorna uma URL para redirecionar o usuário.

Parâmetros de Query

text

?projectId=proj_abc123&redirectUrl=https://yourapp.com/callback

Resposta

json

{
  "url": "https:0
  2: "random_state_value",
  "codeVerifier": "pkce_verifier"
}

POST/v1/oauth/:provider/callback

Tratar Callback OAuth

Troque o código de autorização OAuth por tokens do Authon.

Corpo da Requisição

json

{
  "code": "auth_code_from_provider",
  "state": "random_state_value",
  "codeVerifier": "pkce_verifier",
  "projectId": "proj_abc123"
}

Resposta

json

{
  "accessToken": "eyJhbGci...",
  "refreshToken": "rt_abc123...",
  "expiresIn": 3600,
  "user": {
    "id": "usr_abc123",
    "email": "user@example.com",
    "displayName": "John Doe"
  },
  "isNewUser": false
}