Skip to main content
POST
/
otps
/
{otpId}
Validar OTP
curl --request POST \
  --url https://api.example.com/otps/{otpId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "recipient": "<string>",
  "code": "<string>"
}
'
// No content — OTP validated successfully
Valida o codigo OTP enviado ao admin.

​
Parametros de Path

​
otpId
string
required
O identificador da solicitacao OTP retornado por Enviar OTP.

​
Corpo da Requisicao

​
recipient
string
required
O endereco de email ou numero de telefone do admin. Deve corresponder ao usado no Enviar OTP.
​
code
string
required
O codigo OTP recebido pelo destinatario.

​
Resposta

// No content — OTP validated successfully

​
Exemplos de Codigo

curl -X POST https://api.awsales.io/admin/otps/019525fe-8f80-7afa-f2be-0c2d4e6a8b0e \
  -H "Content-Type: application/json" \
  -d '{
  "recipient": "admin@example.com",
  "code": "123456"
}'

​
Codigos de Erro

StatusCodigoDescricao
400validation_errorEntrada invalida ou campos obrigatorios ausentes
400auth.invalid_codeCodigo OTP invalido ou expirado
500internal_server_errorOcorreu um erro inesperado

​
Respostas 403 Especiais

A validacao OTP pode retornar 403 com sub-codigos especificos que requerem acao adicional:
CodigoDescricaoAcao Necessaria
auth.organization_selection_requiredUsuario pertence a multiplas organizacoesSelecione uma organizacao
auth.method_not_allowedMetodo de autenticacao nao permitido pela organizacaoUse o fluxo de autenticacao correto