5 melhores dicas para maximizar sua experiência com a Transloadit

Sabemos que, às vezes, pode ser difícil entender a Transloadit por completo. Nossa ampla variedade de recursos e parâmetros pode tornar intimidador saber por onde começar, que dirá como otimizar seu fluxo de trabalho. Para ajudar você a dar os primeiros passos, reunimos uma lista de cinco coisas que você pode fazer para aproveitar ao máximo a Transloadit.

1. Use Templates

Embora possa ser tentador manter suas Assembly Instructions perto da sua integração (e, muitas vezes, esse é um caso de uso válido EN (English)), ainda assim recomendamos que você use Templates.

Os Templates são criptografados e armazenados com segurança em nossos servidores, o que significa que você só precisa se preocupar em referenciar o Template ID no ponto de onde você chama a Transloadit. Se suas Assembly Instructions contiverem credenciais de um dos serviços de terceiros com os quais nos integramos, os Templates podem ajudar a diminuir a preocupação de que usuários mal-intencionados obtenham acesso ao armazenamento dos seus arquivos.

E, caso você esteja se perguntando como isso afetaria sua capacidade de passar dados para sua Assembly ou de alterar o funcionamento do seu Template em tempo real, saiba que, na verdade, é possível sobrescrever qualquer parâmetro do seu Template. Basta incluir o JSON do Step e do parâmetro que você está alterando como partes da propriedade steps.

Você pode migrar para Templates aqui!

2. Adote o modo assíncrono

Nas raras ocasiões em que enfrentamos filas de codificação, não queremos que seus usuários finais sintam o impacto disso. A última coisa que os usuários querem é esperar, e é por isso que oferecemos a opção de usar a Transloadit de forma assíncrona.

Especificar uma URL no parâmetro notify_url significa que enviaremos uma requisição POST assim que sua Assembly terminar. Configure seu SDK para não aguardar a codificação, para que seus usuários possam seguir em frente logo que o upload do arquivo terminar.

Se, por algum motivo, seu back-end estiver indisponível para processar a requisição, tentaremos enviar a notificação novamente até cinco vezes, dando aos seus servidores a chance de voltar a ficar online e tratar a requisição.

Consulte nosso guia de webhooks para ver uma implementação completa, incluindo como verificar as assinaturas das notificações antes de processar os resultados.

3. Defina um limite de cobrança!

A menos que você nos diga o contrário, a Transloadit sempre continuará atendendo você, mesmo que seus Jobs de codificação ultrapassem a franquia mensal de GB incluída no seu plano. Afinal, não queremos que seus usuários vejam seu serviço parar de funcionar de repente se você estiver tendo um dia particularmente movimentado.

Ao mesmo tempo, como todo programador sabe, software tem bugs. E, às vezes, um bug assim pode fazer com que, digamos, Assemblies sejam executadas várias vezes mais do que deveriam, gerando custos desnecessários na sua conta.

Para evitar que isso aconteça, recomendamos definir um limite de cobrança na sua conta. Defina-o alto o suficiente para cobrir o uso esperado e baixo o suficiente para evitar excedentes acidentais.

Você pode definir um limite de cobrança acessando a seção de faturamento da sua conta e clicando no botão “Definir limite de cobrança”.

4. Proteja suas requisições

Ao usar o Uppy, o valor de auth_key pode ficar incluído no código-fonte do seu site. Qualquer pessoa pode ver o código-fonte do seu site simplesmente clicando em “Inspect Element”, o que significa que, em teoria, ela poderia executar Assemblies pela sua conta da Transloadit, gerando cobranças para você por um uso que não é seu.

Felizmente, você pode se proteger ativando a Signature Authentication na sua conta. Isso obriga você a gerar uma assinatura para cada requisição feita à Transloadit. Gere a assinatura no seu back-end usando seu auth_secret e os params exatamente como serializados, que incluem seu auth_key e um horário de expiração. Ao criar uma Assembly, envie a assinatura no campo multipart signature junto com params. Mantenha o Auth Secret no seu servidor.

Para ver exemplos, consulte nosso guia de Signature Authentication.

5. Aproveite nossos SDKs

Por último, mas não menos importante, está uma das ferramentas mais importantes à sua disposição para aproveitar ao máximo a Transloadit: use nossos SDKs! Eles costumam vir repletos de recursos que ajudam a simplificar o processo de integração, incluindo alguns dos recursos que mencionamos acima.

Se você não encontrar o SDK que procura entre nossas integrações oficiais, também há várias integrações criadas e mantidas pela nossa comunidade. Confira-as aqui EN (English).

Por hoje é só. Se tiver alguma dúvida ou quiser compartilhar suas próprias dicas e truques, fique à vontade para entrar em contato conosco pelo Twitter⁠!