Códigos de erro

Na maioria dos casos, basta mostrar o erro para a IA: ela lê a sugestão que vem junto e corrige sozinha.

Formato de um erro

Todo erro do Site no Ar traz um código estável (code), o que aconteceu (message) e o que fazer (suggestion). Alguns trazem details, como sugestões de slug livres.

{
  "error": {
    "code": "slug_taken",
    "message": "Slug already in use.",
    "suggestion": "…"
  }
}

Códigos de erro

Código	HTTP	Significado	O que fazer
auth_invalid	401	O login da IA ou do painel não foi concluído, expirou ou foi revogado.	Autentique de novo. Veja A IA não conecta.
plan_upgrade_required	402	O recurso não está no plano (como SEO e analytics fora do Pro e do Diamante) ou o site está suspenso.	Mude de plano. Veja Planos e limites.
product_access_unavailable	403	A conta ainda não tem acesso ao produto.	Entre de novo ou escolha um plano em app.sitenoar.dev/account.
not_found	404	O site, domínio ou publicação não existe nesta conta.	Confira se o site é desta conta.
plan_limit_reached	409	A conta atingiu o limite de sites, domínios próprios, Aplicações Web ou recursos de dados.	Mude de plano, exclua um site ou remova um domínio.
slug_taken	409	O endereço já está em uso ou é reservado.	Escolha outro ou use uma das sugestões.
slug_being_released	409	O endereço é de um site desta conta que está sendo excluído e fica livre em alguns segundos.	Acompanhe com delete_site_status e tente de novo quando a exclusão terminar.
site_busy	409	O site está ocupado com outra operação, como outra publicação.	Aguarde terminar e tente de novo.
site_not_ready	409	O site ainda está sendo criado.	Aguarde o site ficar “No ar”.
site_suspended	409	A ação só funciona em sites ativos.	Reative o site. Veja Sites suspensos e reativação.
file_too_large	413	Um arquivo ou pacote passou do limite de tamanho.	Reduza e envie de novo. Veja Limites técnicos.
slug_invalid	422	O slug não segue as regras de formato.	Use 3 a 63 caracteres com letras minúsculas, números e hífen. Veja Mudar o endereço do site.
path_invalid	422	O caminho de um arquivo é inválido.	Use caminhos relativos como sobre.html, sem .. nem / no início.
rate_limited	429	Muitas requisições em pouco tempo.	Espere alguns instantes e tente de novo.

Erros de publicação

Uma publicação que termina em failed ou policy_blocked não é um código de erro, e sim um status final da publicação, com a causa e a correção sugerida (fix_hint). Veja A publicação falhou.

Próximos passos

A publicação falhouStatus finais e como corrigir.

A IA não conectaResolva erros 401 e problemas de conexão.