> ## Documentation Index
> Fetch the complete documentation index at: https://help.treble.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Chave de API e cabeçalhos webhook

> Para interagir com a API da Treble, você precisará de uma chave de API. Esta chave permitirá que você autentique suas solicitações à API e acesse os endpoints disponíveis. Aprenda a obter sua chave de API neste artigo.

## O que é uma chave de API?

Uma chave de API é um identificador único que é utilizado para autenticar e autorizar as solicitações à API da Treble. Cada chave de API está associada a uma conta específica e tem um conjunto de permissões associadas.

A chave de API que você obterá é uma chave global para toda a conta da Treble.

## Como obter uma chave de API?

Para obter uma chave de API, você deve seguir estes passos:

1. Faça login na sua conta da Treble <a class="article-link" href="https://app.treble.ai/login"><p>Fazer login na Treble</p><Icon icon="arrow-up-right-from-square" iconType="solid" /></a>
2. Na barra de navegação, clique em **Configurações** <Icon icon="gear" iconType="solid" />.
3. Em seguida, clique em **Desenvolvedores**
4. Você encontrará um campo chamado **Chave de API**
5. Copie a chave de API e guarde-a em um lugar seguro.

<img src="https://mintcdn.com/trebleai/9CTpLCIjWruVB-9s/images/api-key-1.gif?s=af5beb914da4fe936175b384620ee6c5" alt="Chave de API" width="2548" height="1456" data-path="images/api-key-1.gif" />

Exemplo:

```
ak_S5BCOgOxrfENbkn-wH2gpPK3AM8ihLNmQg
```

Com esta chave, você poderá autenticar suas solicitações à API da Treble. Para usá-la, você deve adicioná-la no cabeçalho da solicitação como um token de autenticação.

Exemplo:

```
Authorization: ak_S5BCOgOxrfENbkn-wH2gpPK3AM8ihLNmQg
```

## Configurações Avançadas

### Cabeçalhos de Autenticação para webhooks

Se você configurar algum webhook da Treble para o seu sistema de informação, você pode adicionar uma lista de cabeçalhos de autenticação para que a solicitação possa ser autenticada. Estes cabeçalhos serão adicionados a cada solicitação feita ao seu webhook e são definidos em formato JSON.

Exemplo:

```json theme={null}
{
  "Authorization": "Bearer 1234567890",
  "X-API-Key": "1234567890"
}
```

A partir de agora, cada vez que você fizer uma solicitação ao seu webhook, a Treble adicionará estes cabeçalhos à solicitação.

Para configurá-los, vá até a seção de **Webhooks** e adicione os cabeçalhos necessários. Adicione-os e depois clique em **Salvar**.

<img src="https://mintcdn.com/trebleai/QZhc2S1RPxBT1Fym/images/api-key-2.png?fit=max&auto=format&n=QZhc2S1RPxBT1Fym&q=85&s=f9782a321691ae9fe9a743579c4fcde9" alt="Cabeçalhos de Autenticação" width="3456" height="1746" data-path="images/api-key-2.png" />
