Skip to main content
POST
/
auth
/
oauth
/
authorize
OAuth Authorize
curl --request POST \
  --url https://api.example.com/auth/oauth/authorize \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "provider": "<string>",
  "redirectUri": "<string>",
  "state": "<string>"
}
'
{
  "authorizationUrl": "https://accounts.google.com/o/oauth2/v2/auth?...",
  "state": "abc123"
}
Gera uma URL de autorizacao OAuth para Google ou Microsoft. Redirecione o usuario para a URL retornada para iniciar o fluxo OAuth. 
curl -X POST https://api.awsales.io/studio/auth/oauth/authorize \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "GoogleOAuth",
    "redirectUri": "https://app.example.com/auth/callback",
    "state": "random-csrf-token"
  }'

​
Fluxo OAuth

1

Solicite a URL de autorizacao

Chame este endpoint com o provedor OAuth, URI de redirecionamento e parametro state opcional. A API retorna uma authorizationUrl.
2

Redirecione o usuario

Redirecione o navegador do usuario para a authorizationUrl. Ele se autenticara com o provedor OAuth (Google ou Microsoft).
3

Trate o callback

Apos a autenticacao, o provedor redireciona de volta para sua redirectUri com um parametro code. Envie este codigo para o endpoint OAuth Callback para completar a autenticacao.

​
Corpo da Requisicao

​
provider
string
required
Provedor OAuth. Um de: GoogleOAuth, MicrosoftOAuth.
​
redirectUri
string
required
A URI para redirecionar apos a conclusao do OAuth.
​
state
string
Parametro state opcional para protecao CSRF.

​
Resposta

​
authorizationUrl
string
A URL de autorizacao do provedor OAuth.
​
state
string
O parametro state (gerado se nao fornecido).
{
  "authorizationUrl": "https://accounts.google.com/o/oauth2/v2/auth?...",
  "state": "abc123"
}

​
Codigos de Erro

StatusCodigoDescricao
400validation_errorEntrada invalida ou campos obrigatorios ausentes
500internal_server_errorOcorreu um erro inesperado