Validação de Token

Request

Após a geração, faça a validação do token F2A. É importante verificar se sua API está devidamente autenticada.

Validação de token

PUT URL: https://apicore.d1.cx/tfa/token/{token}?validate=true

Utilize estes parâmetros para validação de token em ambiente de produção

Para ambiente de homologação, utilize como endpoint: https://apicore.stg.d1.cx/tfa/token/{token}?validate=true

Headers

Name	Type	Description
Content-Type	string	application/json
Authorization	string	Bearer [OAUTH2-AUTHENTICATION-ACCESS_TOKEN]
TenantId	string	[TENANT-ID] - Identifica a qual conta previamente cadastrada na aplicação deve ser utilizada. Essa informação é fornecida pela D1.

Request Body

Name	Type	Description
tfaProjectId	string	O objetivo desse campo é identificar qual o projeto de 2FA que será utilizado. Essa informação é fornecida pela D1 e deve ser a mesma a qual o token foi gerado.
clientId	string	Código do cliente, deve ser a mesma a qual o token foi gerado.
recipient	string	E-mail ou telefone para ser validado o token, deve ser a mesma a qual o token foi gerado.

200: OK Token validado com sucesso

{
    // Response
}

400: Bad Request Erro na validação do token

{
    "type": "about:blank",
    "title": "BadRequest"
    "status": 400
    "detail": "This token has already been verified."
    "instance": "/token"
}

Atributos:

type: sempre será “about:blank”

title: sempre será “BadRequest”

status: sempre será 400

detail: conterá informações detalhadas sobre o motivo da não validação do token

Response

HTTP/1.1 200 OK
{

}

HTTP/1.1 400 BAD REQUEST
 {
   "type": "about:blank",
   "title": "BadRequest"
   "status": 400
   "detail": "This token has already been verified."
   "instance": "/token"
}

Campos	Descrição
type	Sempre será “about:blank”
title	Sempre será “BadRequest”
status	Sempre será 400
detail	Conterá informações detalhadas sobre o motivo da não validação do token

Token

O token é o qual está sendo requisitada a validação.

Headers

• Content-Type: application/json

• Authorization: Bearer [OAUTH2-AUTHENTICATION-ACCESS_TOKEN]

• TenantId: [TENANT-ID]

Exemplo de requisição

{
  "tfaProjectId": "12345",
  "clientId": "12345",
  "recipient": "5511999999999"
}

Campos	Descrição
tfaProjectId	O objetivo desse campo é identificar qual o projeto de 2FA que será utilizado. Essa informação é fornecida pela D1 e deve ser a mesma a qual o token foi gerado.
clientId	Código do cliente, deve ser a mesma a qual o token foi gerado.
recipient	E-mail ou telefone para ser validado o token, deve ser a mesma a qual o token foi gerado.