Como configurar um subdomínio dedicado para uma API separada do site principal
Olá, querido(a) cliente! Aqui é o Sensei da GeHost — seu parceiro de confiança na jornada digital. Hoje vamos te ensinar, com carinho e clareza, como criar um subdomínio dedicado para sua API, mantendo seu site principal limpo, organizado e seguro. Isso é comum em projetos modernos, onde a parte do front-end (seu site) e o back-end (sua API) precisam de separação clara.
Seja bem-vindo(a) à sua primeira experiência com DevOps no mundo da GeHost! Não se preocupe — mesmo que você não seja técnico, comigo você vai dominar isso passo a passo. Vamos lá?
Passo 1: Acesse o painel do cPanel
Para começar, faça login no painel de controle da sua hospedagem:
- Abra o navegador e vá para painel.gehost.com.br.
- Insira seu usuário de hospedagem (geralmente é o nome do domínio) e a senha (a mesma que você usou para se cadastrar).
Passo 2: Acesse o Editor de Zona de DNS
Uma vez logado, você estará na tela inicial do cPanel. Vamos localizar a ferramenta que nos permite criar subdomínios:
- Procure pela seção Domínios.
- Clique em Editor de Zona de DNS.
Passo 3: Crie um registro CNAME para o subdomínio
Agora vamos criar o subdomínio. Vamos chamá-lo de api.seudominio.com.br (substitua pelo seu domínio real).
- Na seção de registros, clique em CNAME.
- Na caixa de texto, digite o nome do subdomínio: api.
- No campo "Aponta para", insira o nome do domínio principal: seudominio.com.br.
- Clique em Adicionar Registro.
Pronto! Agora o subdomínio api.seudominio.com.br está apontando para o mesmo servidor do seu site principal.
Passo 4: Crie uma pasta para a API no Gerenciador de Arquivos
Para que a API funcione, precisamos de um local no servidor para armazenar os arquivos. Vamos criar uma pasta dentro da área pública do seu site:
- No painel do cPanel, vá até Arquivos → Gerenciador de Arquivos.
- Selecione a pasta public_html (é onde ficam os arquivos do seu site).
- Clique em Novo e crie uma pasta chamada api.
Passo 5: Suba os arquivos da sua API
Com a pasta criada, agora você pode enviar os arquivos da sua API (ex: PHP, Node.js, Python, etc.) para dentro da pasta api no public_html.
- Use o Gerenciador de Arquivos ou um cliente FTP (como FileZilla) para fazer isso.
- Se você estiver usando FTP, conecte-se ao servidor com os dados do painel (host: seu domínio, usuário e senha).
- Envie os arquivos da sua API para a pasta api dentro de public_html.
Seu site principal continua intacto. A API agora está em um local separado, como um "quarto reservado" dentro da casa.
Passo 6: Teste o subdomínio
Finalmente, abra seu navegador e acesse:
https://api.seudominio.com.br
Se tudo estiver certo, você verá a resposta da sua API (ex: uma mensagem de boas-vindas, ou um JSON com dados). Se não funcionar, verifique:
- Se o registro CNAME foi criado corretamente.
- Se os arquivos da API estão na pasta correta.
- Se o servidor está configurado para rodar a linguagem da sua API (ex: Node.js, PHP).
Dica do Sensei
Se você estiver usando um framework (como Laravel, Express, Django), lembre-se de que ele pode precisar de configurações adicionais no .htaccess ou no arquivo de roteamento. Caso precise de ajuda, basta entrar em contato com nosso suporte — estamos aqui para te ajudar!
Conclusão
Parabéns! Você acabou de configurar um subdomínio dedicado para sua API, com segurança, organização e profissionalismo. Isso é o que chamamos de "crescer com propósito" — e você está no caminho certo.
Se tiver dúvidas, não hesite. A GeHost está aqui para te apoiar. E lembre-se: todo grande desenvolvedor começou com um passo simples como este.
Com carinho,
Sensei da GeHost
Seu parceiro na nuvem, desde 2015
Informações institucionais: Grupo G e Soluções e Eventos LTDA (razão social). CNPJ: 46.647.904/0001-04. Para dados fiscais, consulte sua fatura.