5 conseils pour optimiser votre expérience avec Transloadit

Nous comprenons que Transloadit peut parfois être difficile à appréhender. Face à notre large éventail de fonctionnalités et de paramètres, il peut être intimidant de savoir par où commencer, sans parler de la façon d’optimiser votre flux de travail. Pour vous aider à démarrer, nous avons dressé une liste de cinq choses que vous pouvez faire pour tirer le meilleur parti de Transloadit.

1. Utiliser des Templates

Même s’il peut être tentant de garder vos Assembly Instructions au plus près de votre intégration (et c’est souvent un cas d’usage tout à fait valable EN (English)), nous vous recommandons néanmoins d’utiliser des Templates.

Les Templates sont chiffrés et stockés en toute sécurité sur nos serveurs : vous n’avez donc qu’à référencer l’identifiant du Template depuis l’endroit où vous appelez Transloadit. Si vos Assembly Instructions contiennent des informations d’identification pour l’un des services tiers avec lesquels nous sommes intégrés, les Templates peuvent contribuer à dissiper la crainte que des utilisateurs malveillants accèdent à votre stockage de fichiers.

Et si vous vous demandez maintenant quel impact cela aurait sur votre capacité à transmettre des données à votre Assembly ou à modifier le fonctionnement de votre Template à la volée, sachez qu’il est en fait possible de remplacer n’importe quel paramètre de votre Template. Incluez simplement le JSON du Step et du paramètre que vous modifiez dans la propriété steps.

Vous pouvez passer aux Templates ici !

2. Passer en mode asynchrone

Dans les rares cas où nous connaissons des files d’attente d’encodage, nous ne voulons pas que vos utilisateurs finaux en subissent les conséquences. Attendre est bien la dernière chose que souhaitent les utilisateurs, c’est pourquoi nous vous offrons la possibilité d’utiliser Transloadit de manière asynchrone.

Si vous indiquez une URL dans le paramètre notify_url, nous vous enverrons une requête POST dès que votre Assembly sera terminée. Configurez votre SDK pour qu’il n’attende pas la fin de l’encodage, afin que vos utilisateurs puissent continuer dès que l’envoi du fichier est terminé.

Si, pour une raison quelconque, votre back-end n’est pas en mesure de traiter la requête, nous réessaierons d’envoyer la notification jusqu’à cinq fois afin de laisser à vos serveurs le temps de revenir en ligne et de traiter la requête.

Consultez notre guide sur les webhooks pour une implémentation complète, y compris la vérification des signatures des notifications avant le traitement des résultats.

3. Définir une limite de facturation !

Sauf indication contraire de votre part, Transloadit continuera toujours à vous servir, même si vos Jobs d’encodage vous font dépasser le quota mensuel de GB inclus dans votre forfait. Après tout, nous ne voulons pas que vos utilisateurs voient soudainement votre service cesser de fonctionner lors d’une journée particulièrement chargée.

Cela dit, comme tous les développeurs le savent, les logiciels contiennent des bugs. Et parfois, un tel bug pourrait entraîner, par exemple, l’exécution d’Assemblies bien plus de fois que prévu, ce qui engendrerait des coûts inutiles sur votre compte.

Pour éviter cela, nous vous recommandons de définir une limite de facturation sur votre compte. Fixez-la suffisamment haut pour couvrir votre utilisation prévue, et suffisamment bas pour éviter tout dépassement accidentel.

Vous pouvez définir une limite de facturation en vous rendant dans la section de facturation de votre compte et en cliquant sur le bouton « Définir une limite de facturation ».

4. Sécuriser vos requêtes

Lorsque vous utilisez Uppy, votre auth_key peut figurer dans le code source de votre site web. N’importe qui peut consulter le code source de votre site en cliquant simplement sur « Inspect Element », et pourrait donc théoriquement lancer des Assemblies depuis votre compte Transloadit, en vous faisant payer une utilisation qui n’est pas la vôtre.

Heureusement, vous pouvez vous protéger en activant Signature Authentication sur votre compte. Vous devrez alors générer une signature pour chaque requête que vous envoyez à Transloadit. Générez-la sur votre back-end à l’aide de votre auth_secret et de la valeur sérialisée exacte de params, qui inclut votre auth_key et une date d’expiration. Lors de la création d’une Assembly, envoyez-la dans le champ multipart signature avec params. Conservez l’Auth Secret sur votre serveur.

Pour des exemples, consultez notre guide sur Signature Authentication.

5. Tirer parti de nos SDK

Enfin, et ce n’est certainement pas le moindre, voici l’un des outils les plus importants à votre disposition pour tirer le meilleur parti de Transloadit : utilisez nos SDK ! Ils regorgent souvent de fonctionnalités qui simplifient le processus d’intégration, dont certaines de celles que nous avons mentionnées plus haut.

Si vous ne trouvez pas le SDK que vous cherchez parmi nos intégrations officielles, il existe également un certain nombre d’intégrations créées et maintenues par notre communauté. Découvrez-les ici EN (English).

C’est tout pour aujourd’hui. Si vous avez des questions ou souhaitez partager vos propres astuces, n’hésitez pas à nous contacter sur Twitter⁠ !