UNLOCK API
Chave de API
Chaves de API e segurança
MarkdownOpenAPI

Chaves de API e segurança

Como enviar sua chave, usar mais de uma chave e liberar só os seus servidores.

Sua chave

Toda requisição leva a chave de API da página da sua conta: clientKey nas requisições JSON, key em in.php e res.php. Uma chave tem 32 caracteres (0-9, a-f). Mantenha-a no seu servidor; quem tiver a chave pode gastar o seu saldo.
POST /getBalance
{
  "clientKey": "YOUR_API_KEY"
}

Mais chaves

Você pode criar até 5 chaves extras na página da conta, por exemplo uma por servidor ou projeto. Elas compartilham o saldo, mostram quando foram usadas pela última vez e podem ser desativadas uma a uma.

Lista de IPs permitidos

Adicione até 20 endereços IP na página da conta e só esses endereços poderão usar suas chaves. Requisições de outros endereços recebem ERROR_IP_NOT_ALLOWED e não são cobradas.
Erro
{
  "errorId": 1,
  "errorCode": "ERROR_IP_NOT_ALLOWED",
  "errorDescription": "Requests from this IP are not allowed. Add it to the IP allow list on your account page."
}

Chamadas pelo navegador

in.php e res.php adicionam o header CORS Access-Control-Allow-Origin: * quando você envia header_acao=1. Chamar a API de uma página web pública expõe sua chave, então use isso só nas suas próprias ferramentas.