Usar um token de API do cPanel na linha de comando serve para executar chamadas autenticadas à API diretamente por terminal, shell script ou rotina automatizada.
Na prática, isso permite integrar a conta cPanel com scripts, verificações técnicas e automações sem depender da interface gráfica do painel.
Como acessar o cPanel
- https://seudominio.com.br/cpanel
- https://seudominio.com.br:2083
- pela área do cliente MyWay
Como usar um token de API do cPanel na linha de comando
Antes de começar
Antes de usar o token na linha de comando, você precisa ter:
- um token já criado no cPanel
- o nome de usuário da conta cPanel
- o domínio ou hostname de acesso ao cPanel
- conexão segura via HTTPS
Nunca use o token em conexões inseguras ou em scripts expostos publicamente.
Como funciona a autenticação
Na chamada de API, o token é enviado no cabeçalho de autorização juntamente com o usuário da conta cPanel.
Em termos práticos, o padrão costuma seguir esta lógica:
- Authorization: cpanel usuario:token
Ou seja, a linha de comando informa ao servidor qual é o usuário da conta e qual token deve ser aceito como credencial de autenticação.
Exemplo com curl
Um exemplo típico de chamada pode ser feito com curl:
curl -H"Authorization: cpanel USUARIO_CPANEL:TOKEN_AQUI" "https://seudominio.com.br:2083/execute/Modulo/funcao"
Nesse formato:
- USUARIO_CPANEL = usuário da conta
- TOKEN_AQUI = valor do token gerado
- Modulo/funcao = endpoint da API que você deseja executar
Esse padrão permite chamar funções da UAPI diretamente por linha de comando com autenticação via token.
Exemplo conceitual de estrutura
- curl = utilitário de linha de comando para requisições HTTP
- -H = envia cabeçalho HTTP
- Authorization = cabeçalho de autenticação
- /execute/ = caminho comum para chamadas UAPI
Cuidados práticos ao usar no terminal
- não exponha o token no histórico do shell sem necessidade
- prefira usar variável de ambiente ou arquivo seguro
- evite colar o token em locais compartilhados
- sempre use HTTPS
- teste primeiro em ambiente controlado
Se você deixar o token salvo em histórico de terminal, scripts públicos ou prints, terceiros podem reutilizá-lo.
Exemplo de uso em script
Em automações, é comum armazenar o token em variável de ambiente e chamar o endpoint por script.
Exemplo conceitual:
TOKEN="seu_token"
USER="seu_usuario"
curl -H"Authorization: cpanel ${USER}:${TOKEN}" "https://seudominio.com.br:2083/execute/Modulo/funcao"
Essa abordagem ajuda a organizar melhor o script e pode facilitar substituição futura do token.
Quando isso é útil
- consultas automáticas
- scripts administrativos
- integrações com sistemas internos
- rotinas recorrentes de verificação
- painéis técnicos próprios
Resultado esperado
Ao final, você conseguirá autenticar chamadas de API do cPanel diretamente pela linha de comando usando o token criado na conta.
O resultado esperado é ter automação técnica funcional sem precisar usar a senha principal da hospedagem.
Resumo
Para usar um token de API do cPanel na linha de comando:
1. crie o token no cPanel
2. tenha em mãos o usuário da conta
3. use uma chamada via curl
4. envie o cabeçalho Authorization: cpanel usuario:token
5. chame o endpoint correto da API
6. proteja o token no terminal, em scripts e no armazenamento
1. crie o token no cPanel
2. tenha em mãos o usuário da conta
3. use uma chamada via curl
4. envie o cabeçalho Authorization: cpanel usuario:token
5. chame o endpoint correto da API
6. proteja o token no terminal, em scripts e no armazenamento
Usar token por linha de comando é muito útil, mas exige cuidado extra com histórico de shell, arquivos e permissões.
Atenciosamente,
MyWay Hosting
Servidores Otimizados por inteligência artificial
www.myway.com.br
