Pular para o conteúdo principal

Erros Comuns

401 Unauthorized​

Causa comum: API key ausente, invalida ou expirada.

Checklist:

  • Confirme header Authorization: Bearer <API_KEY>.
  • Teste GET /api/v1/users/me.
  • Gere nova chave se necessario.

403 Forbidden​

Causa comum: chave valida, mas sem permissao para o recurso.

Checklist:

  • Verifique organizacao/projeto selecionado na conta.
  • Confira se a chave pertence ao mesmo usuario/tenant da conversa.

404 Not Found​

Causa comum: conversation_id ou task_id inexistente.

Checklist:

  • Valide se o ID foi copiado completo.
  • Consulte em lote por ids para confirmar existencia.

422 Validation Error​

Causa comum: payload fora do schema esperado.

Checklist:

  • Valide formato JSON.
  • Confira tipos e nomes de campos no OpenAPI.

429 Too Many Requests​

Causa comum: excesso de chamadas em janela curta.

Checklist:

  • Implemente backoff exponencial.
  • Reduza polling agressivo.

5xx Server Error​

Causa comum: erro temporario no backend.

Checklist:

  • Retry com backoff e jitter.
  • Registre request_id (se presente) para suporte.