Pular para o conteúdo principal

Autenticação

Para utilizar as APIs é é preciso efetuar uma requisição ao servidor de autenticação para obter um Token de Acesso válido.

Solicitar uma conta de serviço​

É preciso solicitar a criação de uma conta de serviço ao gerente de projetos responsável por sua conta. Ao criar sua conta, um e-mail é enviado contendo os dados necessários sua autenticação:

  • Nome de conta;
  • Identificador de sua empresa (Tenant ID);
  • ID da chave;

Essa informações são usadas na geração do JWT.

Gerar um JWT (JSON Web Token)​

Para obter um Token de Acesso válido, você deve enviar um JWT na requisição ao servidor de autenticação. Este JWT é composto por três blocos (header, payload e assinatura) codificados, e separados pelo caractere . (ponto final). Para mais informações, consulte Criando o JWT.

Fazer uma requisição para obter o token de acesso​

Após gerar o JWT assinado, faça uma requisição para a plataforma de autenticação. Para mais informações, consulte Fazendo a requisição de um token de acesso.

Usar o token de acesso para chamar as APIs​

Com o token de acesso válido, basta chamar as APIs usando este token no header de suas requisições, junto ao parâmetro Authorization.

Dúvidas?​

Não encontrou algo ou ainda precisa de ajuda? Se já é um cliente ou parceiro, pode entrar em contato através da Central de Ajuda.