# Chaves de API

Criação, permissões, proteção e revogação das credenciais.

## Criar sua credencial

- Entre na sua conta VibeCash.
- Ative a autenticação em dois fatores em Definições → Segurança.
- Abra Integrações → API e escolha criar uma chave.
- Defina as permissões e os IPs que poderão utilizá-la.
- Copie o segredo exibido na criação.

A chave `tp_live_...` autoriza as operações selecionadas. Use-a no seu servidor e evite colocá-la em páginas públicas, logs ou repositórios.

## Headers

```
X-API-Key: tp_live_SUA_CHAVE
Content-Type: application/json
Idempotency-Key: operacao-unica-123
```

## Escopo e permissões

O escopo `read` permite leitura, `write` permite escrita e `full` também permite exclusões. A chave precisa da permissão específica de cada rota. [Consulte as permissões.](/docs/pages/guides/api-permissions)

## Rotação e revogação

Crie outra credencial, atualize sua integração e revogue a anterior no painel. O segredo original não pode ser consultado novamente.
