Pular para o conteúdo principal

🛠️ Solução de problemas da API Oficial

Use este guia para verificar se a API Oficial está em execução na VPS e reiniciar os serviços quando a conexão não estiver funcionando.

aviso

Antes de continuar, confirme que a API Oficial foi instalada seguindo o tutorial de instalação.

Mantenha também o sistema e a API Oficial atualizados. Após uma atualização do sistema, execute o atualizador da API Oficial.


🔎 Verificar se a API está online​

Acesse o terminal da VPS e execute o comando abaixo:

curl -fsS http://127.0.0.1:6000/ >/dev/null && echo "API OFICIAL OK" || echo "API OFICIAL FALHOU"

Se o resultado for API OFICIAL OK, a API está respondendo localmente.


📋 Conferir o processo, a porta e a resposta da API​

Execute os comandos abaixo para confirmar que o processo está em execução, que a porta 6000 está disponível e que a API responde por HTTP.

Confirmar o processo em execução​

pgrep -af "api_oficial/dist/main.js"

Confirmar a porta da API​

ss -ltnp | grep ":6000"

Testar a resposta HTTP​

curl -sS -i http://127.0.0.1:6000/ | head -n 10

📄 Ver os logs da API Oficial​

Para acompanhar os logs, altere para o usuário deploy:

su - deploy

Em seguida, execute:

pm2 logs

🔄 Reiniciar os serviços​

Se a conexão continuar sem funcionar, siga os passos abaixo.

Etapa 1: reiniciar os serviços como root​

No terminal da VPS, como usuário root, execute:

pm2 restart all --update-env

Etapa 2: reiniciar os serviços como deploy​

Altere para o usuário deploy:

su - deploy

Depois, execute:

pm2 restart all --update-env

Após concluir os dois passos, retorne ao sistema e teste a conexão novamente.

informação

Este procedimento considera que o aplicativo da Meta já está configurado corretamente e que os dados informados na conexão estão corretos. Caso exista alguma informação incorreta, a conexão não funcionará mesmo após reiniciar os serviços.