Se você ainda não sabe o que é ou para que serve os seus tokens de API, neste artigo vamos te explicar o que são, a utilidade e te mostrar como criar, remover ou como usar os tokens. Se você deseja criar, ou já criou um sistema/aplicação externa (fora do seu painel) que realiza ações como criar contas de e-mail, criar contas FTP, alterar senha de conta de e-mail, etc. Os tokens de API são essenciais.
A principal função dos Tokens de API é dar permissão para que usuários e/ou sistemas consigam se autenticar e realizar ações do cPanel, porém, de forma externa. Com os tokens, é possível realizar as requisições de forma autenticada, o que permite a conclusão das ações, como criar uma conta de e-mail, por exemplo. Esses tokens servem como uma senha alternativa, evitando a necessidade de utilizar a sua senha de usuário em sistemas.
Como criar uma Token de API
- Acesse o painel de controle da sua hospedagem (cPanel)
- Agora role a página para baixo até a seção Segurança e clique na opção Gerenciar tokens de API
- Para criar o seu Token, basta dar um nome, e escolher se o token será permanente ou temporário. Após preencher com o nome e selecionar a opção que desejar, é só clicar em Criar.
Importante: Se você optar por especificar uma data, esse token vai expirar quando a data informada chegar, e deixará de funcionar. - Na próxima tela, você verá o token e é essencial que você copie e salve o token em um local seguro, não será possível encontrar esse token novamente depois no seu painel. Após copiar e salvar o token, é só clicar em Sim, Eu Salvei Meu Token.
- Pronto, agora seu token já está criado e completamente pronto para uso.
Como editar ou remover um token
Para editar ou remover, você ainda deve estar na opção Gerenciar Tokens de API no cPanel. Segue os passos abaixo:
- Se você possuir tokens criados, ao acessar a tela de gerenciamento, você vai conseguir encontrá-los na lista, com o nome, data e hora de criação. Clique em Gerenciar ao lado do token que deseja editar/remover.
- Agora, se você desejar renomear o token, é só informar um novo nome, e em seguida clicar em Atualizar. Caso deseje remover, você deve clicar na opção Revogar O Token.
Como usar o seu token de API
Você pode usar os seus tokens de API de várias formas para realizar ações na sua hospedagem através do seu site/aplicação. Por exemplo, se você desejar visualizar suas contas de e-mail, criar contas de e-mail e editar a senha das contas tudo isso de forma externa ao seu painel de controle da hospedagem, é totalmente possível através das APIs do cPanel.
Para exemplificar, você pode considerar utilizar plugins no seu site WordPress para realizar essa conexão, ou construir de forma manual, com a ajuda de seu programador. A conexão geralmente é feita com usuario:token, e caso seja feito de forma manual, é extremamente importante que você saiba os comandos corretos para as APIs do cPanel. Para isso, você pode dar uma olhada na documentação oficial do cPanel: Clique aqui se você possui uma Revenda, ou Clique aqui se você possui uma hospedagem.
Além das opções que eu citei acima, você também pode considerar comprar uma licença do WHMCS, que é uma plataforma de automação que também pode realizar as integrações com tokens de API, de forma a profissionalizar e aprimorar o seu negócio. Reforçamos que, se você não tiver o conhecimento necessário na área de programação, recomendamos que consulte o seu programador de confiança para realizar as ações necessárias para você.