Chaves de API
DocsChaves de API

Chaves de API

Crie e gerencie chaves de API para acesso programático à API REST do RaxyProxy.

Criar uma chave

Vá para Painel → Chaves de API e clique em Criar nova chave. Dê um nome descritivo (ex., scraper-prod), depois clique em Gerar.

Sua chave é exibida uma vez — copie-a imediatamente. Ela não será exibida novamente. As chaves seguem o formato:

raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

O prefixo raxy_ é seguido por 40 caracteres alfanuméricos aleatórios.

Usar uma chave

Passe a chave como token Bearer no cabeçalho Authorization de cada requisição de API:

request.sh
curl https://raxyproxy.com/api/v1/account \
     -H "Authorization: Bearer raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

As chaves são vinculadas à sua conta — elas podem listar pacotes, recuperar estatísticas e gerar strings de proxy. Elas não podem modificar as configurações da conta ou efetuar pagamentos.

Melhores práticas de segurança

Nunca exponha sua chave de API

Uma chave de API concede acesso de leitura à sua conta e credenciais de proxy. Trate-a como uma senha — armazene-a em variáveis de ambiente ou um gerenciador de segredos, nunca em código-fonte ou repositórios públicos.

  • Use uma chave separada por aplicação ou ambiente
  • Armazene chaves em variáveis de ambiente (RAXY_API_KEY=raxy_xxx...)
  • Adicione .env ao seu .gitignore
  • Rotacione chaves periodicamente ou imediatamente após uma suspeita de vazamento
.env
RAXY_API_KEY=raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Revogar uma chave

Em Painel → Chaves de API, clique no ícone de exclusão ao lado da chave que deseja revogar. A revogação é imediata — qualquer requisição usando essa chave receberá uma resposta 401 Unauthorized.

Se suspeitar que uma chave foi comprometida, revogue-a imediatamente e crie uma nova. As sessões de proxy existentes não são afetadas — apenas o acesso à API é bloqueado.