Apresentando USER_COMMAND_ERROR para entender melhor os erros
Além do já existente INTERNAL_COMMAND_ERROR, nossa API agora pode retornar
um novo código de erro: USER_COMMAND_ERROR. Isso permite distinguir melhor se um
erro foi causado por uma entrada incorreta fornecida pelo usuário ou por um problema interno da
Transloadit. Essa melhoria permite que você identifique e resolva rapidamente problemas ligados às
instruções específicas fornecidas, garantindo uma experiência mais fluida no geral.
Apesar de todos os nossos esforços, nem toda operação de transcodificação será concluída com sucesso. Nesses casos, as Assemblies falham e são marcadas como malsucedidas. Normalmente, as falhas têm uma de três causas:
- O arquivo fornecido está malformado ou corrompido, por exemplo, um arquivo de imagem sem os últimos bytes.
- As instruções fornecidas contêm erros, por exemplo, a ausência de uma senha para um documento PDF criptografado.
- O arquivo e as instruções fornecidos estão corretos, mas um problema interno causou a falha da operação.
Antes, em todos esses casos, a Assembly terminava com o status de erro
INTERNAL_COMMAND_ERROR. No entanto, esse status dificulta, tanto para nossos usuários quanto
para nós, que operamos o serviço, a distinção entre erros causados por arquivos malformados ou
instruções incorretas e aqueles causados por erros internos. Essa distinção é importante para que
nossos usuários determinem quais erros podem resolver por conta própria, enquanto nos permite
concentrar esforços na correção dos problemas internos o mais rápido possível.
O que vai mudar?
A partir de agora, erros causados por arquivos malformados ou instruções incorretas farão com que a
Assembly falhe com o novo status USER_COMMAND_ERROR. Isso indica que
surgiu um problema que os próprios usuários podem resolver, por exemplo, corrigindo as Assembly
Instructions.
As Assemblies que falharem devido a problemas internos da Transloadit continuarão
sendo marcadas com o status INTERNAL_COMMAND_ERROR, permitindo que investiguemos e resolvamos
o problema o mais rápido possível.
O que isso significa para os usuários?
A maioria dos usuários não precisa fazer nenhuma alteração na integração. Você só precisa agir se o
código da sua integração com a Transloadit verificar o status INTERNAL_COMMAND_ERROR, por
exemplo, para registrar logs ou iniciar novas tentativas. Nesses casos, também é aconselhável
considerar o novo status USER_COMMAND_ERROR.
Como sempre, nossa equipe de suporte está à disposição para ajudar você com qualquer dúvida ou preocupação. Fique à vontade para entrar em contato, e teremos prazer em orientar você sobre essas mudanças.