Wir stellen USER_COMMAND_ERROR für klarere Fehlereinblicke vor
Zusätzlich zum bereits bestehenden Fehlercode INTERNAL_COMMAND_ERROR kann unsere API nun
einen neuen Fehlercode zurückgeben: USER_COMMAND_ERROR. So lässt sich besser
unterscheiden, ob ein Fehler durch fehlerhafte Eingaben der Nutzer oder durch eine interne
Transloadit-Störung verursacht wurde. Diese Verbesserung ermöglicht es Ihnen, Probleme im
Zusammenhang mit den jeweils übermittelten Anweisungen schnell zu erkennen und zu beheben, was
insgesamt für einen reibungsloseren Ablauf sorgt.
Trotz aller Bemühungen wird nicht jeder Transcoding-Vorgang erfolgreich abgeschlossen. In diesen Fällen brechen die Assemblies mit einem Fehler ab und werden als fehlgeschlagen markiert. In der Regel haben Fehlschläge einen von drei Gründen:
- Die bereitgestellte Datei ist fehlerhaft aufgebaut oder beschädigt, zum Beispiel eine Bilddatei, der die letzten paar Bytes fehlen.
- Die bereitgestellten Anweisungen enthalten Fehler, zum Beispiel wenn für ein verschlüsseltes PDF-Dokument kein Passwort angegeben wird.
- Die bereitgestellte Datei und die Anweisungen sind korrekt, aber eine interne Störung hat den Vorgang scheitern lassen.
Bisher endete die Assembly in all diesen Fällen mit dem
Fehlerstatus INTERNAL_COMMAND_ERROR. Dieser Status macht es unseren Nutzern – und uns als
Betreibern des Dienstes – jedoch schwer, zwischen Fehlern durch fehlerhafte Dateien oder
Anweisungen und Fehlern durch interne Probleme zu unterscheiden. Diese Unterscheidung ist für
unsere Nutzer wichtig, um zu erkennen, welche Fehler sie selbst beheben können, und sie erlaubt es
uns, uns darauf zu konzentrieren, interne Probleme so schnell wie möglich zu beheben.
Was ändert sich?
Ab sofort führen Fehler, die durch fehlerhafte Dateien oder falsche Anweisungen verursacht werden,
dazu, dass die Assembly mit dem neuen Status
USER_COMMAND_ERROR fehlschlägt. Das zeigt an, dass ein Problem aufgetreten ist, das die
Nutzer selbst beheben können, zum Beispiel durch das Korrigieren der Assembly Instructions.
Assemblies, die aufgrund Transloadit-interner Störungen
fehlschlagen, werden weiterhin mit dem Status INTERNAL_COMMAND_ERROR markiert, sodass wir
das Problem so schnell wie möglich untersuchen und lösen können.
Was bedeutet das für Nutzer?
Die meisten Nutzer müssen an ihrer Integration nichts ändern. Sie müssen nur dann aktiv werden,
wenn Ihr Integrationscode mit Transloadit den Status INTERNAL_COMMAND_ERROR prüft, etwa für
Logging oder für das Starten von Retries. In diesen Fällen ist es ratsam, auch den neuen Status
USER_COMMAND_ERROR zu berücksichtigen.
Wie immer steht Ihnen unser Support-Team bei Fragen und Anliegen zur Seite. Melden Sie sich gern bei uns, und wir helfen Ihnen gerne, sich in diesen Änderungen zurechtzufinden.