Démêler le jargon de Transloadit : un guide complet
Vous découvrez Transloadit et vous vous noyez dans un océan de termes techniques ? Pas d’inquiétude, nous sommes là pour vous aider ! Dans cet article, nous passons en revue une partie du jargon propre à Transloadit, afin que vous puissiez parcourir la documentation de Transloadit en toute confiance la prochaine fois.
Robots et Jobs
En coulisses, Transloadit fonctionne en exécutant des outils tels que FFmpeg sur un fichier. L’exécution d’un tel outil crée un Job, la plus petite unité logique sur laquelle tout le reste repose.
Les Jobs ne peuvent toutefois pas s’exécuter d’eux-mêmes, et c’est là qu’interviennent nos Robots. Chaque Robot de notre arsenal est spécialisé dans une tâche unique, et il existe un nombre infini de combinaisons de Robots capables de créer des fonctionnalités complexes, comme un générateur de cartes musicales (English).
Templates, Assemblies et Assembly Instructions
Un seul Robot peut déjà accomplir des choses impressionnantes, mais lorsque nous commençons à assembler plusieurs Robots en une chaîne d’assemblage – ou, comme nous aimons le dire, en Assembly Instructions –, nous pouvons créer des choses vraiment formidables. Chaque Robot effectue un seul Step du processus, ce qui aboutit au final à une fonctionnalité supérieure à la somme de ses parties.
Les serveurs de Transloadit peuvent ensuite analyser vos Assembly Instructions et exécuter les outils back-end nécessaires pour produire vos fichiers transcodés. Nous utilisons le terme Assembly pour désigner une exécution unique des Assembly Instructions.
Bien sûr, il n’est pas toujours idéal de transmettre un nouvel ensemble d’Assembly Instructions chaque fois que vous souhaitez créer une Assembly. C’est pourquoi nous avons créé les Templates. Avec les Templates, il vous suffit d’indiquer à Transloadit le nom de votre Template, et nous suivrons ensuite votre recette JSON soigneusement élaborée. Nous avons présenté certains des avantages des Templates dans un récent article de blog : 5 façons de tirer le meilleur parti de Transloadit.
Synchrone ou asynchrone
Par défaut, Transloadit renvoie l’état actuel de l’Assembly dans l’Assembly Status JSON, auquel vous pouvez vous abonner et que vous pouvez interroger régulièrement afin de vérifier si l’Assembly est terminée. C’est ce que l’on appelle utiliser Transloadit de manière synchrone, ou en mode synchrone.
Cependant, nous vous proposons également d’interagir avec Transloadit de manière asynchrone.
Renseignez notify_url et définissez waitForEncoding sur false, et nous enverrons une requête
POST à votre back-end lorsque l’Assembly aura terminé l’encodage. Ainsi, votre utilisateur
ne sera pas bloqué pendant que vos serveurs attendent la fin du transcodage. Vous pouvez en
apprendre davantage sur la configuration du mode asynchrone et sur la vérification des
signatures de notification dans notre guide des webhooks.
Les Assembly Replays constituent une autre fonctionnalité utile, disponible indépendamment du mode synchrone ou asynchrone. Si un problème est survenu pendant l’exécution de votre Assembly et que les fichiers avaient déjà été téléversés avec succès, Transloadit peut réexécuter l’Assembly dans un délai de 24 heures. Cela se produit automatiquement en cas de dysfonctionnement d’un serveur, mais peut aussi être déclenché manuellement depuis la console de Transloadit.
C’est tout pour aujourd’hui !
Voilà qui conclut notre visite éclair de la terminologie de Transloadit.
Nous espérons que cet article a dissipé toute confusion que vous auriez pu avoir. Comme toujours, n’hésitez pas à nous contacter si vous avez besoin d’aide concernant l’une des fonctionnalités de Transloadit.