Documentação Pixel Host
Autenticação e tokens
Crie tokens na aba API do servidor e conceda somente as permissões necessárias.No painel, abra o servidor, entre em API e clique em Criar token. Informe um nome, marque somente os escopos necessários, escolha a expiração e confirme. Copie o valor ph_srv_ exibido: ele aparece uma única vez.
Guarde o token no ambiente da aplicação que fará as requisições, por exemplo PIXEL_HOST_TOKEN. Não coloque o token no config.yml do PixelHostIntegration, no código-fonte, em parâmetros de URL ou no console do navegador.
Envie o token no cabeçalho Authorization em todas as requisições. Tokens revogados ou expirados retornam HTTP 401; um token sem o escopo necessário retorna HTTP 403.
O curinga * em um token de servidor libera somente aquele servidor. Ele nunca amplia o acesso para toda a conta.
Para testar, exporte PIXEL_HOST_TOKEN no terminal e consulte /servers/SEU_SERVER_ID/status. Uma resposta HTTP 200 traz o JSON de status; 401 indica token inválido ou expirado e 403 indica escopo ausente.
- Expirações disponíveis: 1, 7, 30 ou 90 dias; 1 ano; permanente
- Tokens de conta: conta e servidores autorizados
- Tokens de servidor: somente o servidor vinculado
- Escopos com .* liberam as ações daquele grupo
export PIXEL_HOST_TOKEN="ph_srv_seu_token"
curl -sS \
-H "Authorization: Bearer $PIXEL_HOST_TOKEN" \
https://pixel-host.com.br/api/v1/servers/SEU_SERVER_ID/status