> ## Documentation Index
> Fetch the complete documentation index at: https://docs.salvy.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Chaves de API

> Crie e gerencie chaves de API para integrar seus sistemas com a Salvy

Toda requisição para a API da Salvy precisa de uma chave de API. Ela identifica sua empresa e autoriza o acesso aos recursos da plataforma.

## Acessando a página

Você pode criar, listar e revogar chaves a qualquer momento na página de API & Webhooks, disponível em Configurações > Funcionalidades, ou diretamente em app.salvy.com.br/settings/api.

## Criando uma chave

1. Acesse a página de [API & Webhooks](https://app.salvy.com.br/settings/api).
2. Clique em **Criar chave de API**.
3. Selecione o ambiente da chave (**Sandbox** ou **Produção**) no seletor exibido acima do campo de nome. Veja <a href={"/api-reference/" + v + "/environments"}>Ambientes</a> para entender a diferença.
4. Dê um nome (opcional) à chave para identificá-la depois, por exemplo o sistema ou a finalidade em que ela será usada.
5. Clique em **Criar chave**.

<Warning>
  A chave é exibida apenas uma vez. Copie e guarde-a em um local seguro antes de
  fechar a janela.
</Warning>

Após copiar a chave, use-a no cabeçalho `Authorization` das suas requisições:

```
Authorization: Bearer <sua_chave>
```

Consulte a <a href={"/api-reference/" + v + "/introduction"}>Introdução</a> para mais detalhes sobre autenticação.

## Revogando uma chave

Para revogar uma chave, clique no ícone de lixeira na coluna **Ações** e confirme a ação.

<Warning>
  A revogação é imediata e não pode ser desfeita. Qualquer sistema que esteja
  utilizando a chave deixará de acessar a API assim que a revogação for
  confirmada.
</Warning>

Chaves revogadas continuam visíveis na tabela com o status **Revogada**, junto com a data e o usuário responsável pela revogação, para fins de auditoria.

## Boas práticas

* Crie uma chave separada para cada sistema ou finalidade (como produção, homologação ou integrações diferentes). Isso facilita o rastreamento e a revogação quando necessário.
* A Salvy tem os ambientes **sandbox** e **produção**, definidos pela chave utilizada. Use chaves de sandbox para desenvolvimento e testes. Entenda a diferença em <a href={"/api-reference/" + v + "/environments"}>Ambientes</a>.
* Nunca compartilhe chaves em repositórios públicos, e-mails ou mensagens. Armazene-as em um cofre de segredos.
* Revogue imediatamente qualquer chave que possa ter sido exposta e crie uma nova em seu lugar.
* Utilize nomes descritivos ao criar chaves para facilitar a identificação posterior.