Liberação de IP
Cadastre os IPs dos servidores que chamam a API. Chamada de IP fora da lista é recusada.
A API só aceita chamadas com chave de API vindas de IPs cadastrados na sua conta. Mesmo que a chave vaze, ela não funciona fora dos seus servidores.
| Conta | Liberação de IP |
|---|---|
| Brasileira | Obrigatória |
| Uruguaia | Opcional, recomendada |
Cadastrar um IP
No painel, abra Integração.
Adicione o IP público de saída de cada servidor que vai chamar a API. Repita para cada IP.
Salve. A liberação vale para as chamadas seguintes, sem trocar a chave.
Cadastre o IP antes de gerar a chave
O painel só gera chave de API para contas com pelo menos um IP cadastrado.
Quando a chamada é recusada
Uma chamada com chave válida vinda de IP fora da lista recebe 403:
{
"statusCode": 403,
"code": "API_KEY_IP_NOT_ALLOWED",
"message": "Este IP não está na whitelist de IP da conta (Integrações).",
"traceId": "8f0c2a4e-3d7b-4c1e-9a52-6b1f0e7d2c91"
}Se toda chamada de uma integração nova falha com 403, confira primeiro:
- O IP cadastrado é o de saída do servidor, como a internet o vê, e não o IP interno da rede. Em nuvem, é o IP do NAT ou do balanceador de saída.
- Servidores com IP dinâmico (autoscaling, serverless) precisam de um IP de saída fixo para funcionar com a liberação.
Ainda com dúvida, fale com o suporte e
informe o traceId da resposta.