Skip to main content
POST
/
auth
/
sign-in
Sign In
curl --request POST \
  --url https://api.example.com/auth/sign-in \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "<string>",
  "password": "<string>"
}
'
{
  "accessToken": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
  "refreshToken": "dGhpcyBpcyBhIHJlZnJlc2ggdG9rZW4...",
  "expiresIn": 3600
}
Autentica um usuario com email e senha. Retorna tokens JWT para requisicoes subsequentes a API.
curl -X POST https://api.awsales.io/studio/auth/sign-in \
  -H "Content-Type: application/json" \
  -d '{
    "email": "user@example.com",
    "password": "your-password"
  }'
Armazene o accessToken em memoria e o refreshToken em um cookie seguro HTTP-only ou armazenamento criptografado. Nunca exponha tokens em URLs ou local storage onde ataques XSS podem acessa-los.

Corpo da Requisicao

email
string
required
Endereco de email do usuario.
password
string
required
Senha do usuario.

Resposta

accessToken
string
Access token JWT para autenticar requisicoes a API.
refreshToken
string
Token para obter novos access tokens sem re-autenticacao.
expiresIn
integer
Tempo de expiracao do access token em segundos.
{
  "accessToken": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
  "refreshToken": "dGhpcyBpcyBhIHJlZnJlc2ggdG9rZW4...",
  "expiresIn": 3600
}

Codigos de Erro

StatusCodigoDescricao
400validation_errorEntrada invalida ou campos obrigatorios ausentes
401auth.invalid_credentialsEmail ou senha incorretos
500internal_server_errorOcorreu um erro inesperado

Respostas Especiais 403

O fluxo de sign-in pode retornar 403 com sub-codigos especificos que requerem acao adicional:
CodigoDescricaoAcao Necessaria
auth.organization_selection_requiredUsuario pertence a multiplas organizacoesChame Trocar Organizacao
auth.otp_verification_requiredVerificacao de email pendenteComplete a verificacao OTP
auth.method_not_allowedUsuario registrado via um metodo de autenticacao diferenteUse o fluxo de autenticacao correto (ex.: OAuth ao inves de senha)