Erros

Formato padrão

Erros 400, 401 e 502 retornam uma string:

{ "error": "Descrição do problema" }

Erros 422 (validação de parâmetros) retornam um objeto por campo:

{
  "error": {
    "campo": ["mensagem de validação"]
  }
}

Referência por código

400 — Bad Request

Mensagem	Causa
"Missing X-Api-Key header"	Header X-Api-Key não enviado
"Invalid JSON body"	Body do POST /alunos não é JSON válido

401 — Unauthorized

{ "error": "API Key inválida" }

A mensagem exata vem do banco de dados e pode variar (ex: key inativa, expirada, sem permissão para o endpoint). O código 401 indica sempre um problema com a X-Api-Key.

422 — Unprocessable Entity

Disparado quando um parâmetro de query ou campo do body não passa pela validação de schema. O objeto error contém uma chave por campo inválido com array de mensagens.

Exemplo — ativo com valor inválido:

{
  "error": {
    "ativo": ["Invalid enum value. Expected 'true' | 'false', received 'sim'"]
  }
}

Exemplo — p_nome ausente no POST /alunos:

{
  "error": {
    "p_nome": ["Required"]
  }
}

Exemplo — UUID inválido:

{
  "error": {
    "academia_id": ["Invalid uuid"]
  }
}

502 — Bad Gateway

Indica problema de comunicação entre o Worker e o Supabase (timeout, erro interno do banco). Não causado pelo client. Entre em contato com a equipe Dinamo se persistir.

Dicas de diagnóstico

• 401 → confirme com a Dinamo se sua chave está ativa e tem permissão para o endpoint que está chamando.
• 422 → leia o objeto error para identificar qual campo está errado e consulte a API Reference para ver os valores aceitos.