Builtin Templates: stabile, versionierte Transformationen
Manchmal möchten Sie mit einem soliden, umfassend getesteten Template starten, statt eines
von Grund auf neu zu erstellen. Heute kündigen wir Builtin Templates an: von Transloadit gepflegte, versionierte
Templates, die Sie wie jedes andere Template per template_id referenzieren können.
Builtin Templates sind für gängige Transformationen und schnelle Bausteine konzipiert. Sie sind stabil, versioniert, und Sie können eine bestimmte Version fixieren, wenn Sie eine änderungskontrollierte Bereitstellung benötigen.
Was sind Builtin Templates?
Builtin Templates befinden sich in API2 und werden über Slugs identifiziert, die mit builtin/ beginnen, zum
Beispiel:
builtin/encode-hls-video@0.0.1builtin/serve-preview@0.0.1
Sie können sie über template_id verwenden:
builtin/<name>verweist auf die neueste bekannte Version.builtin/<name>@latestist ein expliziter Alias für die neueste bekannte Version.builtin/<name>@<version>fixiert eine bestimmte Version.
Warum Builtin Templates verwenden?
- Starten Sie mit einer etablierten, bewährten Baseline für gängige Transformationen.
- Halten Sie Ihre Integration schlank: Sie müssen kein Template erstellen, nur um etwas auszuprobieren.
- Fixieren Sie Versionen für vorhersehbares Verhalten und aktualisieren Sie, wenn Sie bereit sind.
- Kombinieren Sie sie mit Ihren eigenen Steps, indem Sie sie zur Laufzeit überschreiben – wie jedes andere Template.
Kurzes Beispiel: eine Assembly mit einem Builtin Template erstellen
So sieht eine Assembly-Anfrage mit einem Builtin Template aus:
{
"template_id": "builtin/encode-hls-video"
}
Sie können Steps weiterhin zur Laufzeit überschreiben oder erweitern (zum Beispiel, um einen Storage-Export-Step hinzuzufügen), genauso wie bei jedem anderen Template. Weitere Informationen zum Überschreiben finden Sie unter Templates.
Verfügbare Optionen entdecken
Die kanonische Liste und Nutzungshinweise finden Sie in der Dokumentation:
Wenn sie in API-Listings angezeigt werden sollen, können Sie sie mit include_builtin in GET /templates einschließen
(siehe Endpoint-Referenz für Details):
Wie es weitergeht
Builtin Templates haben heute noch einen kleinen Funktionsumfang, und wir werden sie auf Basis realer Nutzung erweitern. Wenn Sie eine Transformation wiederholt ausführen und meinen, dass sie als Builtin Template geeignet ist, lassen Sie es uns wissen.
Wenn Sie Templates noch nicht verwenden, beginnen Sie zuerst damit: