Qu’est-ce qu’un Builtin Template ?
Un Builtin Template est un Template versionné, maintenu par Transloadit et stocké dans API2. Il est référencé par un slug builtin/, par exemple builtin/encode-hls-video@latest.
Fonctionnement des Builtin Templates
Une requête de création d’Assembly peut référencer un graphe de traitement fourni par la plateforme plutôt que contenir ou posséder un Template personnalisé équivalent. Le service résout l’identifiant du Builtin Template et sa version, puis exécute la séquence maintenue avec les entrées de l’appelant et les paramètres pris en charge. La maintenance du flux de travail relève ainsi de la plateforme, tandis que le choix de version reste important pour les tests, la reproductibilité et le déploiement maîtrisé dans les intégrations en production.
Points clés
- 1Les identifiants de Builtin Template occupent l’espace de noms
builtin/, et un suffixe après@sélectionne un alias de version ou une version, au lieu de faire partie du nom d’un fichier téléversé. - 2Une référence
@latestest volontairement évolutive : un même code client peut ainsi être résolu vers un graphe maintenu plus récent ; une version fixe fournit une dépendance stable pour le flux de travail. - 3Le graphe intégré définit les étapes de traitement, pas les médias de l’appelant eux-mêmes. La création de l’Assembly doit toujours fournir des entrées valides ainsi que tous les paramètres requis par ce flux de travail précis.
Quand les Builtin Templates sont importants
Référencez un Builtin Template lorsque son flux de travail maintenu correspond aux étapes de traitement requises. Fixez une version précise lorsque la reproductibilité est importante, car @latest peut intégrer des modifications ultérieures.