Token de API

Documentação necessária para obtenção de um Token de API no dChat.

O que é um Token de API?

Para realizar requisições via API no dChat é necessária a obtenção de uma Token de API, que também pode ser chamado de Chave de API.

Esta chave é um código único que será exibido uma única vez e é através dela que teremos certeza que a requisição está vindo do seu assinante.

Após a obtenção dessa chave, todas as requisições para a API devem conter a chave em seu cabeçalho HTTP através do Authorization Bearer.

O que é um Bearer Token?

Um Bearer Token é um tipo de token de autenticação usado para acessar recursos protegidos em APIs. Ele é incluído no cabeçalho Authorization das requisições HTTP no formato:

Authorization: Bearer <token>

Como utilizá-lo:

  1. Obtenha o token dentro de dChat.
  2. Inclua o token no cabeçalho Authorization das requisições.
  3. O servidor valida o token e, se for válido, concede acesso ao recurso solicitado.

Ele é amplamente usado em autenticação baseada em OAuth 2.0.

Obtendo um token de API

  1. Acesse o dChat e clique em Tokens de API.

    image.png

  2. Uma lista com os Tokens já criados será exibida. Clique em Adicionar no canto superior direito.

    image.png

  3. Defina um nome e se necessário uma validade para o Token e clique em Enviar.

    image.png

  4. Você será redirecionado para a listagem de Tokens com um aviso contendo seu Token.
    Atenção: Nunca compartilhe esse token com ninguém! Copie em um lugar seguro! Esse código não aparecerá em lugar nenhum nunca mais, caso o perca será necessário criar um novo.

    image.png

  5. Pronto! Você já está apto a realizar requisições na API do dChat.