# 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](https://sistema.dchat.com.br) e clique em **Tokens de API.** [![image.png](https://docs.dchat.com.br/uploads/images/gallery/2025-02/scaled-1680-/9SYqsfTvb67lWpk1-image.png)](https://docs.dchat.com.br/uploads/images/gallery/2025-02/9SYqsfTvb67lWpk1-image.png)
2. Uma lista com os Tokens já criados será exibida. Clique em **Adicionar** no canto superior direito.  
    [![image.png](https://docs.dchat.com.br/uploads/images/gallery/2025-02/scaled-1680-/CC6LL4amW0Zmr4wp-image.png)](https://docs.dchat.com.br/uploads/images/gallery/2025-02/CC6LL4amW0Zmr4wp-image.png)
3. Defina um nome e se necessário uma validade para o Token e clique em **Enviar**.  
    [![image.png](https://docs.dchat.com.br/uploads/images/gallery/2025-02/scaled-1680-/7tFDyPgK8pWnE8hS-image.png)](https://docs.dchat.com.br/uploads/images/gallery/2025-02/7tFDyPgK8pWnE8hS-image.png)
4. Você será redirecionado para a listagem de Tokens com um aviso contendo seu Token.   
    <span style="color: rgb(224, 62, 45);">**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.** </span>[![image.png](https://docs.dchat.com.br/uploads/images/gallery/2025-02/scaled-1680-/JWgWyh8RDajKWsHQ-image.png)](https://docs.dchat.com.br/uploads/images/gallery/2025-02/JWgWyh8RDajKWsHQ-image.png)
5. Pronto! Você já está apto a realizar requisições na API do dChat.