Códigos de erro - Cube Hosting

Formato

Todo erro volta com o status HTTP certo e o mesmo formato:

{
  "status": "error",
  "code": "insufficient_memory",
  "message": "Este bot pede 512 MB, mas o plano Block só tem 256 MB livres. Diminua a memória no cube.json, exclua ou reduza outro projeto, ou mude de plano.",
  "freeMemoryMb": 256,
  "requestedMemoryMb": 512
}

Campo	O que é
`code`	Identificador fixo, em inglês. Use este campo no seu código: ele não muda.
`message`	Texto em português para mostrar a uma pessoa. Pode mudar a qualquer momento.
Campos extras	Alguns erros trazem dados a mais, como `limitMb` ou `field`. Estão listados abaixo.

Todo erro 429 traz o cabeçalho Retry-After, com os segundos que faltam. Espere esse tempo antes de tentar de novo.

Autenticação e limites

HTTP 401

A chave não existe, foi revogada ou está fora do formato.O que fazer: Confira o cabeçalho Authorization: Bearer cube_… ou crie outra chave no painel.

HTTP 403

A chave é só de leitura e a rota muda algo.O que fazer: Crie uma chave de leitura e escrita.

HTTP 403

Esta ação não aceita chave de API.O que fazer: Faça pelo painel. Veja o que a API faz.

HTTP 401

A rota é só do painel e o pedido veio sem sessão.O que fazer: Use uma rota da API pública ou faça pelo painel.

HTTP 429

A conta passou dos pedidos por minuto ou por dia do plano.O que fazer: Espere o Retry-After. Veja os limites.

HTTP 429

Ações pesadas seguidas: envio de .zip (1 a cada 3 s) ou abertura de logs (1 a cada 5 s por projeto, até 5 abertos).O que fazer: Espere o Retry-After e tente de novo.

HTTP 429

10 chaves erradas do mesmo IP em 10 minutos. Chaves erradas desse IP ficam bloqueadas por 15 minutos.O que fazer: Corrija a chave. Uma chave certa continua passando.

Pedidos

HTTP 400

Um parâmetro ou o corpo está fora do formato (por exemplo, lines acima de 1000 ou uma variável com nome inválido).O que fazer: Leia a message: ela diz qual campo.

HTTP 415

O corpo não veio como JSON. Acontece, por exemplo, no curl -d sem o cabeçalho Content-Type, que manda o corpo como formulário.O que fazer: Mande Content-Type: application/json junto do corpo.

HTTP 413

O corpo JSON do pedido é grande demais.O que fazer: Mande só o que a rota pede. As variáveis, somadas, vão até 32 KB. Para o .zip, o limite é outro: veja invalid_zip.

HTTP 404

O projeto não existe ou não é da sua conta.O que fazer: Confira o ID. A resposta é a mesma nos dois casos, de propósito.

HTTP 500

Algo falhou do nosso lado.O que fazer: Tente de novo em instantes. Se continuar, fale com a gente.

Envio do .zip e configuração

HTTP 413 ou 422

413: o .zip passou do limite do plano. Traz limitMb. 422: não é um .zip, está corrompido, vazio ou tem senha.O que fazer: Tire node_modules, venv e o que o projeto não usa (veja Limites do .zip), ou compacte de novo, sem senha.

HTTP 422

Tem atalhos, caminhos para fora da pasta, arquivos especiais ou cresce demais ao descompactar. Traz reason: path, link, special_file, size, file_count ou compression_ratio.O que fazer: Compacte só os arquivos do projeto.

HTTP 422

Sem cube.json no .zip e sem language e command no formulário.O que fazer: Mande um cube.json ou os campos no formulário.

HTTP 422

O cube.json ou o formulário tem um campo errado ou desconhecido, ou port/subdomain num bot. Traz field, quando dá para saber.O que fazer: Corrija o campo indicado.

HTTP 422

Linguagem ou versão fora da lista. Traz supported.O que fazer: Use Node.js 20, 22 ou 24, ou Python 3.11 ou 3.12.

HTTP 422

A memória pedida passa do que sobra no plano. Traz freeMemoryMb e requestedMemoryMb.O que fazer: Diminua a memória deste ou de outro projeto, exclua um que não usa ou mude de plano.

HTTP 403

O plano já tem o máximo de projetos. Traz limit.O que fazer: Exclua um projeto ou mude de plano.

HTTP 403

Site ou API num plano sem sites (Free).O que fazer: Envie como bot ou veja os planos pagos.

HTTP 403

O plano já tem o máximo de sites. Traz limit.O que fazer: Exclua um site ou mude de plano.

HTTP 422

Subdomínio fora do formato. Traz field.O que fazer: De 3 a 32 caracteres: letras minúsculas, números e hífen, sem hífen nas pontas.

HTTP 422

Nome reservado, ou que lembra banco, marca ou órgão público. Traz field.O que fazer: Escolha outro.

HTTP 409

Outro site já usa esse subdomínio. Traz field.O que fazer: Escolha outro.

HTTP 409

Os servidores estão cheios agora.O que fazer: Tente de novo mais tarde. Nada foi cobrado nem apagado.

Iniciar, parar e reiniciar

HTTP 409

O projeto está instalando ou já tem outra ação em curso.O que fazer: Espere alguns segundos e tente de novo.

HTTP 409

A última instalação falhou, então não há o que iniciar.O que fazer: Confira os logs da instalação, corrija e envie o código de novo.

HTTP 422

Ligar este projeto passa da memória do plano com os que já estão ligados. Traz freeMemoryMb e requestedMemoryMb.O que fazer: Pare outro projeto ou diminua a memória deste.

HTTP 409

A conta está suspensa por falta de pagamento. Parar continua liberado.O que fazer: Pague em Plano e cobrança. Veja Pagamento por Pix.

HTTP 409

O beta acabou de terminar e a conta está voltando ao Free.O que fazer: Espere alguns minutos. Nada foi apagado.

HTTP 503

O servidor dos projetos não respondeu a tempo.O que fazer: Tente de novo em instantes. Nada foi alterado.

HTTP 503

Não deu para abrir as variáveis do projeto agora. Aparece também ao iniciar, reiniciar ou enviar código novo, porque o projeto não sobe sem as variáveis.O que fazer: Tente de novo em instantes. Nada foi gravado.

Estados de erro do projeto

Quando um projeto fica Com erro ou Em loop de erro, o campo error do projeto traz um destes códigos. Eles não são erros HTTP: são o motivo de o projeto não estar no ar.

Logs › Instalação

A instalação das dependências ou o build terminou com erro.O que fazer: Corrija o pacote ou a versão e envie de novo.

Logs › Instalação

A instalação passou de 5 minutos.O que fazer: Diminua as dependências.

Logs › Instalação

A instalação passou de 1 GB de memória.O que fazer: Tire dependências que só servem para desenvolvimento.

Logs › Instalação

Um problema do nosso lado interrompeu a instalação.O que fazer: Envie o código de novo.

Logs › Aplicação

O comando de início não subiu.O que fazer: Confira o comando e o arquivo principal.

Logs › Aplicação

O processo caiu no plano Free, que não reinicia sozinho.O que fazer: Corrija e inicie de novo.

Logs › Aplicação

O projeto caiu 5 vezes seguidas e parou de reiniciar.O que fazer: Corrija o erro e inicie de novo.

No painel, o botão Por que caiu? pede um diagnóstico para Cube AI a partir dos logs.

Páginas que o visitante do seu site vê

Para as páginas de site parado, sem resposta ou endereço inexistente, veja Sites e APIs.

​Formato

​Autenticação e limites

​Pedidos

​Envio do .zip e configuração

​Iniciar, parar e reiniciar

​Estados de erro do projeto

​Páginas que o visitante do seu site vê

Formato

Autenticação e limites

Pedidos

Envio do .zip e configuração

Iniciar, parar e reiniciar

Estados de erro do projeto

Páginas que o visitante do seu site vê