Taxonomia de erros de API para pipelines de arquivos
Defina classes de erro estaveis e acionaveis para APIs de upload e processamento.
Codigo
Seguranca
Documento
Imagem
Video
Audio
Arquivo
Por que a taxonomia de erros importa
Sem uma taxonomia estavel, clientes e suporte nao conseguem distinguir erro do usuario de defeito de plataforma. Um modelo tipado de erros melhora a logica de retry, a qualidade da telemetria e a triagem de incidentes.
Classes recomendadas
- input_invalid: entrada do usuario malformada ou contra a politica.
- type_mismatch: divergencia entre extensao, assinatura e parser.
- processing_failed: falha de decode, transcode ou extracao.
- resource_limited: quota, timeout ou budget de concorrencia excedido.
- internal_error: falha inesperada do servico.
Regras operacionais
Cada classe deve mapear para status codes deterministas, politica de retry e padroes de mensagens para o usuario. Instrumente metricas por classe e codigo de motivo para que regressos sejam mensuraveis.
Ferramentas recomendadas
Inspetor MIME
Compare extensao e assinaturas para detectar incompatibilidades de tipo.
Abrir ferramentaClassificador MIME em lote
Classifique muitos arquivos de uma vez e destaque riscos de incompatibilidade.
Abrir ferramentaGerador e verificador de checksum
Calcule SHA256 e verifique a integridade do arquivo com hashes esperados.
Abrir ferramenta