Eine Assembly mit einer vorgegebenen ID erstellen

Erstellt eine Assembly unter einer neuen, vom Aufrufer gewählten Assembly ID.

PUThttps://api2.transloadit.com/assemblies/{assemblyId}

Erstellt eine Assembly mit einer neuen, vom Aufrufer bereitgestellten ID. Dadurch wird keine vorhandene Assembly ersetzt. Sie dürfen eine Assembly ID niemals wiederverwenden, auch nicht, nachdem eine Assembly abgelaufen ist oder gelöscht wurde. Bei einem Konflikt mit einer aktiven ID kann ASSEMBLY_COULD_NOT_BE_CREATED zurückgegeben werden; bei einer protokollierten früheren Verwendung kann DO_NOT_REUSE_ASSEMBLY_IDS zurückgegeben werden. Diese Prüfungen sind keine Garantie für eine dauerhafte Deduplizierung. Dieser Endpunkt ist kein Mechanismus für idempotente Wiederholungsversuche.

Typischer Ablauf:

Senden Sie das folgende Anfragebeispiel mit Ihrer Datei und Ihren Instructions zur Verarbeitung. Um den endgültigen Status über einen Webhook zu erhalten, fügen Sie diesen Instructions vor dem Senden der Anfrage notify_url hinzu.
Halten Sie die zurückgegebene assembly_ssl_url geheim. Verwenden Sie sie, um den Fortschritt zu prüfen, oder warten Sie auf Ihren konfigurierten Webhook.
Warten Sie auf ok: "ASSEMBLY_COMPLETED", bevor Sie die verarbeiteten Dateien verwenden. Ein error oder ein Abbruch stellt keine erfolgreiche Verarbeitung dar. Die Ausgabedateien sind in results nach Step-Namen gruppiert; siehe die Antwortfelder.

Assemblies, die /transloadit/import direkt oder über ein Template verwenden, benötigen entweder ein Bearer-Token oder signierte params mit einem in der Zukunft liegenden Zeitstempel für params.auth.expires. Dies gilt auch, wenn Signature Authentication für den Workspace deaktiviert ist. Ein Auth Key allein reicht nicht aus; mit einem Bearer-Token authentifizierte Anfragen benötigen keine separate Signature und keine separate Ablaufzeit.

Verwenden Sie Eine Assembly erneut ausführen, um die Verarbeitung wiederherstellbarer Eingaben als neue Assembly erneut zu versuchen, oder Eine Assembly abbrechen, um eine vorhandene Assembly zu stoppen.

Anfragebeispiel

Die folgende Anfrage verwendet openssl, um eine neue, unvorhersehbare Assembly ID zu erzeugen. Erzeugen Sie für jede Anfrage eine neue ID; verwenden Sie niemals eine ID erneut.

Führen Sie diese Anfrage in einer serverseitigen Shell mit curl und einem geeigneten Bearer-Token in TRANSLOADIT_TOKEN aus. Wenn Sie ein Token benötigen, klappen Sie die folgende Einrichtungsanleitung auf.

Legen Sie Ihre Eingabedatei unter ./example.jpg ab, bevor Sie die Anfrage ausführen.

Benötigen Sie ein Bearer-Token?

Setzen Sie in einer vertrauenswürdigen serverseitigen Shell mit curl und jq die Variablen TRANSLOADIT_KEY und TRANSLOADIT_SECRET auf Ihren Auth Key bzw. Ihr Auth Secret. Halten Sie beide Zugangsdaten und das daraus resultierende Token geheim; führen Sie diese Einrichtung niemals in Browsercode aus.

Erstellen Sie zunächst ein Token mit den für diesen Endpunkt erforderlichen Scopes. Ihr Auth Key muss diese Scopes bereits gewähren.

if ! TOKEN_RESPONSE="$(curl --fail-with-body -sS \
  --request POST \
  --url 'https://api2.transloadit.com/token' \
  --user "${TRANSLOADIT_KEY:?Set TRANSLOADIT_KEY}:${TRANSLOADIT_SECRET:?Set TRANSLOADIT_SECRET}" \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'grant_type=client_credentials' \
  --data-urlencode 'aud=api2' \
  --data-urlencode 'scope=assemblies:write')"; then
  printf '%s\n' "$TOKEN_RESPONSE" >&2
  exit 1
fi
TRANSLOADIT_TOKEN="$(printf '%s' "$TOKEN_RESPONSE" |
  jq -er '.access_token | strings | select(length > 0)')" || exit 1

Lassen Sie diese Shell geöffnet und führen Sie die folgende Anfrage aus. Verwenden Sie das Token wieder, solange es gültig ist.

ASSEMBLY_ID="$(openssl rand -hex 16)" || exit 1

curl --fail-with-body -sS --request PUT \
  --url "https://api2.transloadit.com/assemblies/${ASSEMBLY_ID:?Set ASSEMBLY_ID}" \
  --header "Authorization: Bearer ${TRANSLOADIT_TOKEN:?Set TRANSLOADIT_TOKEN}" \
  --form-string 'params={"steps":{"resize":{"robot":"/image/resize","use":":original","width":320}}}' \
  --form 'file=@./example.jpg'

Was als Nächstes geschieht

Mit einer erfolgreichen HTTP-Antwort wird die Assembly angenommen; dies bedeutet nicht, dass die Verarbeitung abgeschlossen ist. Eine erste Antwort kann so aussehen (Auszug; IDs und URLs werden abweichen):

{
  "ok": "ASSEMBLY_EXECUTING",
  "assembly_id": "0fce5b1063e611e88d8eb130f7921d8a",
  "assembly_ssl_url": "https://api2-morven.transloadit.com/assemblies/0fce5b1063e611e88d8eb130f7921d8a",
  "results": {}
}

Kopieren Sie assembly_ssl_url aus Ihrer Antwort und prüfen Sie den Status alle paar Sekunden, oder verwenden Sie einen Webhook, der vor der Erstellung konfiguriert wurde. Halten Sie diese URL geheim. Beenden Sie den Vorgang bei einem error oder einem Abbruch; keines von beiden stellt eine erfolgreiche Verarbeitung dar.

Wenn ok den Wert ASSEMBLY_COMPLETED hat, befindet sich die Ausgabe dieses Beispiels in results.resize. Eine Antwort nach Abschluss enthält die folgenden Felder (Auszug; die Ausgabe-URL dient der Veranschaulichung):

{
  "ok": "ASSEMBLY_COMPLETED",
  "message": "The Assembly was successfully completed.",
  "assembly_id": "0fce5b1063e611e88d8eb130f7921d8a",
  "results": {
    "resize": [
      {
        "name": "example.jpg",
        "mime": "image/jpeg",
        "ssl_url": "https://example.com/temporary-output/example.jpg",
        "meta": {
          "width": 320
        }
      }
    ]
  }
}

Verwenden Sie results.resize[0].ssl_url, um das skalierte Bild herunterzuladen. Diese temporären Ausgabe-URLs laufen ab; fügen Sie einen Export-Step wie /s3/store hinzu, wenn Sie die Dateien aufbewahren müssen.

Authentifizierung

Dieser Endpunkt akzeptiert signierte params oder ein Bearer-Token. Anweisungen zur Einrichtung finden Sie unter Authentifizierung.

Erforderlicher Berechtigungsumfang für Auth Key oder Bearer-Token: assemblies:write.

Mit einem Schlüssel authentifizierte Anfragen benötigen eine Signatur, wenn Signature Authentication aktiviert ist. Bearer-Tokens benötigen keine separate Signatur.

Pfadparameter

assemblyId (Pfadsegment), erforderlich. Muster: ^[a-z0-9]{32}$

Optionale Query-Parameter für die Antwort

callback (JavaScript-Callback-Name). Umschließt JSON-Antworten mit einem JSONP-Callback. Der Callback-Name muss ^(?:_jqjsp[0-9]*|jQuery[0-9]+_[0-9]+)$ entsprechen. Nur das letzte Vorkommen wird verwendet; ein leerer Wert wird ignoriert. Ungültige Callback-Namen geben HTTP 403 zurück. Die transformierte Antwort verwendet HTTP 200. Der Callback wird nach der Serialisierung der Antwort angewendet.

Multipart-Formularfelder

Content-Type: multipart/form-data

params (JSON-Zeichenfolge), erforderlich. Ein JSON-codiertes Objekt, dessen unterstützte Schlüssel unten aufgeführt sind.
signature (Zeichenfolge). Erforderlich, wenn die Anfrage Signature Authentication verwendet.
num_expected_upload_files (Formularfeld). Bei fortsetzbaren Uploads gibt dieser Wert die Anzahl der hochzuladenden Dateien an. Weitere Details finden Sie unter Fortsetzbare Uploads.
tus_num_expected_upload_files (Formularfeld). Historischer Alias für num_expected_upload_files, der aus Kompatibilitätsgründen mit älteren SDKs beibehalten wird.
* (Binärdaten oder Zeichenfolge). Binärdateien und zusätzliche Assembly-Felder dürfen beliebige Feldnamen verwenden.

Unterstützte Schlüssel im Feld `params`

Die Authentifizierungsfelder in dieser Liste gelten für signierte Anfragen. Mit einem Bearer-Token können Sie params.auth und das separate Feld signature weglassen. Vergleichen Sie unten die Anfrageparameter der einzelnen Authentifizierungsmethoden.

Vollständiges JSON Schema

JSON in einem neuen Tab öffnen

Signierte Parameter zum Erstellen einer Assembly aus direkten Steps oder einem Template.

Feld	Typ und Beschreibung
`params.auth` für signierte Anfragen erforderlich; mit einem Bearer-Token optional	`object` Authentifizierungsmetadaten und Upload-Beschränkungen für eine signierte Assembly-Anfrage. Der API-Schlüssel ist erforderlich. Enthält mindestens Ihren Transloadit Auth Key in der Eigenschaft `key`. Wenn Sie Signature Authentication aktivieren, müssen Sie außerdem in der Eigenschaft expires ein Ablaufdatum für die Anfrage festlegen: `{ "key": "23c96d084c744219a2ce156772ec3211", "expires": "YOUR_FUTURE_ISO_8601_TIMESTAMP" }` Wir empfehlen dringend, eine zufällig generierte Eigenschaft `nonce` einzuschließen. Ihr Wert ist für jede Anfrage eindeutig, macht unabhängig voneinander generierte Signatures unterscheidbar, erleichtert die Fehlersuche und verhindert die versehentliche Wiederverwendung von Signatures. Ein `nonce` macht Wiederholungsversuche nicht idempotent: Wenn Sie eine Anfrage zur Erstellung einer Assembly wiederholen, kann eine weitere Assembly erstellt werden. Sorgen Sie bei Bedarf in Ihrer Anwendung für die Deduplizierung von Wiederholungsversuchen. Verwenden Sie signierte `params` nicht über mehrere Endpunkte hinweg wieder. Lesezugriffe auf Templates, das Auflisten von Auth Keys, das Auflisten von Template-Zugangsdaten und Lesezugriffe auf Abrechnungsdaten lehnen Signatures, die bereits für einen anderen Endpunkt erfasst oder zur Erstellung einer Assembly verwendet wurden, mit `SIGNATURE_REUSE_DETECTED` ab. Generieren Sie für jede Anfrage neue signierte params. `{ // … "nonce": "04ac6cb6-df43-41fb-a7fd-e5dd711a64e1" }` Die Eigenschaft `referer` ist ein regulärer Ausdruck, der mit dem HTTP-Referer dieses Uploads abgeglichen wird, beispielsweise `"example\.org"`. Geben Sie diesen Schlüssel an, um sicherzustellen, dass Uploads nur von Ihrer Domain stammen. Uploads ohne Referer werden immer zugelassen (da dieser bei einigen Browsern deaktiviert ist), sodass diese Prüfung nur in wenigen Anwendungsfällen nützlich ist. Einzelheiten zu regulären Ausdrücken finden Sie in Mozillas RegExp-Dokumentation. Die Eigenschaft `max_size` begrenzt die gesamte erwartete Upload-Größe der Assembly in Bytes, beispielsweise `1048576` (1 MB), und nicht die Größe jeder einzelnen Datei. Dazu zählen der Body der Multipart-Anfrage oder die Bytes der anfänglichen Assembly-Anfrage zuzüglich ihrer fortsetzbaren Uploads. Eine Überschreitung des Limits stoppt die gesamte Assembly mit einem Fehler, einschließlich der Dateien, die einzeln innerhalb des Limits liegen. Verlassen Sie sich nicht darauf, dass dieses Limit jede zu große Übertragung bereits vor ihrem Beginn zurückweist. Bei fortsetzbaren Uploads wird die angegebene oder empfangene Größe über tus-Aktualisierungen verfügbar, und die Assembly prüft das Limit, wenn ein abgeschlossener Upload verarbeitet wird. Die Größe eines aufgeschobenen Uploads ist bei der Erstellung nicht bekannt, und es können bereits Bytes übertragen worden sein, bevor die Assembly ihn zurückweist. Wenn Sie lediglich die Dateien ignorieren möchten, die eine bestimmte Größe überschreiten, aber alle anderen verarbeiten möchten, verwenden Sie bitte 🤖/file/filter. Mit der Eigenschaft `max_number_of_files` können Sie eine maximale Anzahl von Dateien festlegen, die ein Upload enthalten darf, beispielsweise `100`. Geben Sie diese Eigenschaft an, um zu verhindern, dass Benutzer übermäßig viele Dateien hochladen, sowohl über Datei-Uploads als auch über Import-Robots. Diese Eigenschaften können als Teil der Assembly-Anfrage oder als Teil des Templates festgelegt werden. `params.auth`: Es werden nur die für dieses Objekt aufgeführten Felder akzeptiert.
`params.auth.expires`	`string` ISO-8601-Ablaufzeitstempel in der Zukunft. Erforderlich, wenn eine Anfrage signiert ist oder Signaturauthentifizierung erfordert; mit Bearer authentifizierte Anfragen können ihn weglassen.
`params.auth.key` erforderlich	`string` Transloadit API-Schlüssel zur Authentifizierung von Anfragen
`params.auth.max_number_of_files`	`integer` (Minimum: 1) Maximale Anzahl von Eingabedateien pro Assembly. Wenn die Anzahl hochgeladener oder importierter Dateien diesen Grenzwert überschreitet, wird die Assembly mit einem Fehler gestoppt. Dies hilft, Missbrauch zu verhindern, wenn Zugangsdaten für Signature Authentication offengelegt werden.
`params.auth.max_size`	`number` Maximale erwartete Gesamtgröße des Uploads in Bytes für die Assembly, einschließlich des Overheads des Request-Bodys. Dies ist kein Limit pro Datei und garantiert keine Ablehnung, bevor eine fortsetzbare Übertragung beginnt.
`params.auth.nonce`	`string \| integer` Eindeutiger Zufallswert, der in die Parameter signierter Anfragen aufgenommen wird, damit jede Signatur eindeutig ist und nicht versehentlich wiederverwendet werden kann.
`params.auth.referer`	`string` Regulärer Ausdruck, der mit dem HTTP-Referer abgeglichen wird, um den Ursprung des Uploads einzuschränken
`params.emit_execution_progress`	`boolean` Setzen Sie diesen Wert auf true, um Ereignisse zum Ausführungsfortschritt der Assembly in Echtzeit zu veröffentlichen. Bei URL Transform Assemblies wird diese Einstellung ignoriert.
`params.exiftool_stack`	`string` Wählt den ExifTool-Stack für die Metadatenextraktion in dieser Assembly aus. Der Verarbeitungsstack für Robot Steps wird dadurch nicht ausgewählt.
`params.ffmpeg_stack`	`string` Wählt den FFmpeg-Stack für die Metadatenextraktion in dieser Assembly aus. Dadurch wird nicht der Verarbeitungs-Stack für Robot Steps ausgewählt. Setzen Sie `ffmpeg_stack` im betreffenden Robot Step, um dessen Verarbeitungs-Stack auszuwählen.
`params.fields`	`object` Ein Objekt mit durch Zeichenfolgen bezeichneten Werten (Name -> Wert), die ebenso wie zusätzliche Formularfelder als Assembly Variables verwendet werden können. Als Wert können Sie alles verwenden, was sich in einen JSON-String umwandeln lässt. Schema für zusätzliche Eigenschaften `beliebiger Wert`
`params.imagemagick_stack`	`string` Wählt den ImageMagick-Stack für die Metadatenextraktion in dieser Assembly aus. Dadurch wird nicht der Verarbeitungsstack für Robot Steps ausgewählt. Legen Sie `imagemagick_stack` für den betreffenden Robot Step fest, um dessen Verarbeitungsstack auszuwählen.
`params.mediainfo_stack`	`string` Wählt den MediaInfo-Stack für die Metadatenextraktion in dieser Assembly aus. Damit wird nicht der Verarbeitungs-Stack für Robot Steps ausgewählt.
`params.mplayer_stack`	`string` Wählt den MPlayer-Stack für die Metadatenextraktion in dieser Assembly aus. Dadurch wird nicht der Verarbeitungsstack für Robot Steps ausgewählt.
`params.nonce`	`string \| number` Eindeutiger Zufallswert, der in die Parameter signierter Anfragen aufgenommen wird, damit jede Signatur eindeutig ist und nicht versehentlich wiederverwendet werden kann.
`params.notification_payload`	`Array<"without_params" \| "without_result_meta_data" \| "without_results" \| "without_upload_meta_data" \| "without_uploads">` Steuert die Größe der Nutzlast, die in Assembly Notifications gesendet wird. Beim erneuten Versand von Notifications werden Filter aus der ursprünglichen Assembly-Anfrage wiederverwendet; Filter, die nur in einem Template definiert sind, bleiben beim erneuten Versand nicht erhalten. Ein leeres Array (Standard) sendet den vollständigen Assembly Status. Fügen Sie `"without_params"` hinzu, sodass die unverarbeiteten Felder `params`, `template` und `merged_params` der Assembly Instructions ausgelassen werden. Fügen Sie `"without_result_meta_data"` hinzu, sodass `meta` bei jeder Datei in `results` ausgelassen wird. Fügen Sie `"without_results"` hinzu, sodass das übergeordnete Objekt `results` ausgelassen wird. Fügen Sie `"without_upload_meta_data"` hinzu, sodass `meta` bei jeder Datei in `uploads` ausgelassen wird. Fügen Sie `"without_uploads"` hinzu, sodass das übergeordnete Array `uploads` ausgelassen wird. Die Filterung erfolgt vor der Serialisierung. Dadurch reduzieren diese Optionen die Speichernutzung und helfen, bei großen Assemblies Fehler durch zu große Nutzlasten oder unzureichenden Arbeitsspeicher zu vermeiden. Schema eines Array-Elements `"without_params" \| "without_result_meta_data" \| "without_results" \| "without_upload_meta_data" \| "without_uploads"`
`params.notify_url`	`null \| string` Transloadit kann nach Abschluss der Assembly einen Pingback an Ihren Server senden. Wir senden den Assembly Status als JSON-String im Feld `transloadit` einer `application/x-www-form-urlencoded`-POST-Anfrage an die hier angegebene URL. Verwenden Sie `notification_payload`, um die Größe der Nutzlast zu reduzieren (z. B. `without_uploads`, `without_results`, `without_params`). Beim erneuten Versand von Notifications werden nur Filter aus der ursprünglichen Assembly-Anfrage wiederverwendet, nicht Filter, die ausschließlich in einem Template definiert sind.
`params.quiet`	`boolean` Setzen Sie diesen Wert auf true, um die erste Antwort beim Erstellen einer Assembly zu minimieren. Eine erfolgreiche Antwort enthält nur ok und assembly_id; eine Fehlerantwort behält error, http_code, message, reason und assembly_id bei, sofern vorhanden. Dies minimiert die Antwort und ist keine Zugriffskontrolle: Jeder, der die zurückgegebene Assembly ID besitzt, kann weiterhin ohne zusätzliche Authentifizierung den vollständigen Assembly Status einschließlich Feldern und Ergebnissen abrufen. Behandeln Sie Assembly IDs und Status-URLs als geheime Zugriffsmöglichkeiten. Der vollständige Assembly Status wird weiterhin an notify_url gesendet, wenn diese konfiguriert ist.
`params.redirect_url`	`string` URL, zu der ein Browser-Upload nach dessen Abschluss weitergeleitet wird. Die Assembly-ID und die Status-URL werden als Abfrageparameter angehängt; vorhandene Abfrageparameter und Fragmente bleiben erhalten.
`params.response_headers`	`object` Benutzerdefinierte Antwort-Header, die eine Assembly ausgibt. CORS-Überschreibungen gehören in `cors`; andere Schlüssel auf oberster Ebene werden als benutzerdefinierte Header ausgegeben. `params.response_headers`: Auch Felder, die nicht für dieses Objekt aufgeführt sind, werden akzeptiert.
`params.response_headers.cors`	`object` Weitere Schemadetails finden Sie im vollständigen JSON Schema.
`params.usage_tags`	`string` Nutzungs-Tags, die für eine Assembly aufgezeichnet werden.

Eines der folgenden Schemas kann gelten:

erforderliche Eigenschaften: steps, template_id

Parameter zum Erstellen einer Assembly aus direkten Steps oder einem Template.

params: Es werden nur die für dieses Objekt aufgeführten Felder akzeptiert.

Feld	Typ und Beschreibung
`params.steps` erforderlich	`object` Partielle Step-Werte, die mit den benannten Steps des gespeicherten Templates zusammengeführt werden. Ihre vollständige Robot-spezifische Struktur wird nach dem Laden des Templates validiert. Schema für zusätzliche Eigenschaften `object` Weitere Schemadetails finden Sie im vollständigen JSON Schema.
`params.template_id` erforderlich	`string` (minimale Länge: 1) Die ID des Templates, das Ihre Assembly Instructions enthält. Wenn Sie in Ihrem Template `allow_steps_override` auf `false` setzen, schließen sich `steps` und `template_id` gegenseitig aus: Sie dürfen nur einen dieser Parameter angeben.

Variante 2

Parameter zum Erstellen einer Assembly aus direkten Steps oder einem Template.

params: Es werden nur die für dieses Objekt aufgeführten Felder akzeptiert.

Feld	Typ und Beschreibung
`params.steps`	`object` Enthält Assembly Instructions. Schema für zusätzliche Eigenschaften `object` Weitere Schemadetails finden Sie im vollständigen JSON Schema.
`params.template_id`	`string` Die ID des Templates, das Ihre Assembly Instructions enthält. Wenn Sie in Ihrem Template `allow_steps_override` auf `false` setzen, schließen sich `steps` und `template_id` gegenseitig aus: Sie dürfen nur einen dieser Parameter angeben.

Anfrageparameter nach Authentifizierungsmethode

Mit signierten Parametern

Geben Sie Ihren Auth Key als params.auth.key an. Wenn Sie die Anfrage signieren, geben Sie einen in der Zukunft liegenden Zeitstempel für params.auth.expires an und senden Sie die Signature im separaten Feld signature. Die folgenden Felddefinitionen verwenden Pfade innerhalb von params.

Vollständiges JSON Schema

JSON in einem neuen Tab öffnen

Signierte Parameter zum Erstellen einer Assembly aus direkten Steps oder einem Template.

Verwendet die oben angegebenen Felddefinitionen: params.auth, params.emit_execution_progress, params.exiftool_stack, params.ffmpeg_stack, params.fields, params.imagemagick_stack, params.mediainfo_stack, params.mplayer_stack, params.nonce, params.notification_payload, params.notify_url, params.quiet, params.redirect_url, params.response_headers, params.usage_tags

Eines der folgenden Schemas kann gelten:

erforderliche Eigenschaften: steps, template_id

Parameter zum Erstellen einer Assembly aus direkten Steps oder einem Template.

params: Es werden nur die für dieses Objekt aufgeführten Felder akzeptiert.

Verwendet die oben angegebenen Felddefinitionen: params.steps, params.template_id

Variante 2

Parameter zum Erstellen einer Assembly aus direkten Steps oder einem Template.

params: Es werden nur die für dieses Objekt aufgeführten Felder akzeptiert.

Verwendet die oben angegebenen Felddefinitionen: params.steps, params.template_id

Mit einem Bearer-Token

Senden Sie das Bearer-Token im Authorization-Header. Sie können params.auth und das separate Feld signature weglassen. Die übrigen erforderlichen Parameter müssen weiterhin angegeben werden. Die folgenden Felddefinitionen verwenden Pfade innerhalb von params.

Vollständiges JSON Schema

JSON in einem neuen Tab öffnen

Parameter zum Erstellen einer Assembly aus direkten Steps oder einem Template.

Verwendet die oben angegebenen Felddefinitionen: params.emit_execution_progress, params.exiftool_stack, params.ffmpeg_stack, params.fields, params.imagemagick_stack, params.mediainfo_stack, params.mplayer_stack, params.nonce, params.notification_payload, params.notify_url, params.quiet, params.redirect_url, params.response_headers, params.usage_tags

Feld	Typ und Beschreibung
`params.auth`	`object` Authentifizierungsmetadaten und Upload-Beschränkungen für eine Bearer-authentifizierte Assembly-Anfrage. Das Token stellt den API-Schlüssel bereit, sodass dieser in der Anfrage weggelassen werden kann. Die Eigenschaft `referer` ist ein regulärer Ausdruck, der mit dem HTTP-Referer dieses Uploads abgeglichen wird, zum Beispiel `"example\.org"`. Geben Sie diesen Schlüssel an, um sicherzustellen, dass Uploads nur von Ihrer Domain stammen. Uploads ohne Referer bestehen diese Prüfung immer (da Referer bei einigen Browsern deaktiviert sind), sodass dies nur in wenigen Anwendungsfällen nützlich ist. Einzelheiten zu regulären Ausdrücken finden Sie in Mozillas RegExp-Dokumentation. Die Eigenschaft `max_size` begrenzt die erwartete Gesamtgröße der Uploads einer Assembly in Bytes, zum Beispiel auf `1048576` (1 MB), und nicht die Größe jeder einzelnen Datei. Dazu zählen der Multipart-Anfragekörper oder die Bytes der ursprünglichen Assembly-Anfrage zuzüglich ihrer fortsetzbaren Uploads. Bei Überschreitung des Limits wird die gesamte Assembly mit einem Fehler gestoppt, einschließlich der Dateien, die einzeln innerhalb des Limits liegen. Verlassen Sie sich nicht darauf, dass dieses Limit jede zu große Übertragung bereits vor ihrem Beginn zurückweist. Bei fortsetzbaren Uploads wird die deklarierte oder empfangene Größe über tus-Updates verfügbar, und die Assembly prüft das Limit, wenn ein abgeschlossener Upload verarbeitet wird. Die Größe eines aufgeschobenen Uploads ist bei seiner Erstellung nicht bekannt, und es können bereits Bytes übertragen worden sein, bevor die Assembly ihn zurückweist. Wenn Sie lediglich die Dateien ignorieren möchten, die eine bestimmte Größe überschreiten, aber alle anderen verarbeiten möchten, verwenden Sie bitte 🤖/file/filter. Mit der Eigenschaft `max_number_of_files` lässt sich eine maximale Anzahl von Dateien festlegen, die ein Upload enthalten darf, zum Beispiel `100`. Geben Sie diese Eigenschaft an, um zu verhindern, dass Nutzer übermäßig viele Dateien hochladen, sowohl über Datei-Uploads als auch über Import-Robots. Diese Eigenschaften können als Teil der Assembly-Anfrage oder als Teil des Templates festgelegt werden. `params.auth`: Es werden nur die für dieses Objekt aufgeführten Felder akzeptiert.
`params.auth.expires`	`string` ISO-8601-Ablaufzeitstempel in der Zukunft. Erforderlich, wenn eine Anfrage signiert ist oder Signaturauthentifizierung erfordert; mit Bearer authentifizierte Anfragen können ihn weglassen.
`params.auth.key`	`string` Transloadit API-Schlüssel zur Authentifizierung von Anfragen
`params.auth.max_number_of_files`	`integer` (Minimum: 1) Maximale Anzahl von Eingabedateien pro Assembly. Wenn die Anzahl hochgeladener oder importierter Dateien diesen Grenzwert überschreitet, wird die Assembly mit einem Fehler gestoppt. Dies hilft, Missbrauch zu verhindern, wenn Zugangsdaten für Signature Authentication offengelegt werden.
`params.auth.max_size`	`number` Maximale erwartete Gesamtgröße des Uploads in Bytes für die Assembly, einschließlich des Overheads des Request-Bodys. Dies ist kein Limit pro Datei und garantiert keine Ablehnung, bevor eine fortsetzbare Übertragung beginnt.
`params.auth.nonce`	`string \| integer` Eindeutiger Zufallswert, der in die Parameter signierter Anfragen aufgenommen wird, damit jede Signatur eindeutig ist und nicht versehentlich wiederverwendet werden kann.
`params.auth.referer`	`string` Regulärer Ausdruck, der mit dem HTTP-Referer abgeglichen wird, um den Ursprung des Uploads einzuschränken

Eines der folgenden Schemas kann gelten:

erforderliche Eigenschaften: steps, template_id

Parameter zum Erstellen einer Assembly aus direkten Steps oder einem Template.

params: Es werden nur die für dieses Objekt aufgeführten Felder akzeptiert.

Verwendet die oben angegebenen Felddefinitionen: params.steps, params.template_id

Variante 2

Parameter zum Erstellen einer Assembly aus direkten Steps oder einem Template.

params: Es werden nur die für dieses Objekt aufgeführten Felder akzeptiert.

Verwendet die oben angegebenen Felddefinitionen: params.steps, params.template_id

Antwort

Hier sehen Sie ein Beispiel für einen Antworttext:

{
  "account_id": "6c8b8d10d68b11e3a799b579dfce333a",
  "assembly_id": "0fce5b1063e611e88d8eb130f7921d8a",
  "assembly_ssl_url": "https://api2-morven.transloadit.com/assemblies/0fce5b1063e611e88d8eb130f7921d8a",
  "assembly_url": "http://api2.morven.transloadit.com/assemblies/0fce5b1063e611e88d8eb130f7921d8a",
  "bytes_expected": 1687,
  "bytes_received": 1687,
  "bytes_usage": 0,
  "companion_url": "https://api2-morven.transloadit.com/companion/",
  "execution_duration": 0.001,
  "execution_start": "2018/05/30 08:47:19 GMT",
  "fields": {},
  "instance": "morven.transloadit.com",
  "jobs_queue_duration": 0,
  "message": "The Assembly is currently being executed.",
  "ok": "ASSEMBLY_EXECUTING",
  "parent_id": null,
  "queue_duration": 0.04,
  "results": {},
  "start_date": "2018/05/30 08:47:19 GMT",
  "template": null,
  "template_id": null,
  "tus_url": "https://api2-morven.transloadit.com/resumable/files/",
  "update_stream_url": "https://api2-morven.transloadit.com/ws20243?assembly=0fce5b1063e611e88d8eb130f7921d8a",
  "upload_duration": 0.049,
  "uploads": [],
  "uppyserver_url": "https://api2-morven.transloadit.com/companion/",
  "warnings": [],
  "websocket_url": "https://api2-morven.transloadit.com/ws20243"
}

2xx-Erfolg

JSON-Response-Body. application/json text/plain; charset=utf-8

Schema des Response-Bodys

Vollständiges JSON Schema

JSON in einem neuen Tab öffnen

Feld Typ und Beschreibung

null | string

null | string

null | string

null | string

string

string

Die eindeutige ID dieser Assembly. Sie können sie beim Erstellen einer Assembly in einer Datenbank speichern und damit eingehende Notifications zuordnen.

assembly_ssl_url

null | string

Die eindeutige URL, über die Sie den aktuellen Status dieser Assembly abfragen können und die für die Verwendung über SSL/HTTPS vorgesehen ist. Alle API-Anfragen, die an assembly_url gesendet werden, können auch an assembly_ssl_url gesendet werden.

assembly_url

null | string

Die eindeutige URL, über die Sie den aktuellen Status dieser Assembly abfragen können.

build_id

string

Optionale Build-Kennung zur Fehleranalyse durch den Support. Leiten Sie daraus keine Bedeutung ab; sie kann sich zwischen Assemblies ändern.

bytes_expected

number

Die Anzahl der Bytes, deren Upload diese Assembly erwartet.

bytes_received

number

Die Anzahl der Bytes, die bisher zu dieser Assembly hochgeladen wurden. Dieser Wert wird hauptsächlich von Clients verwendet, um den Upload-Fortschritt anzuzeigen.

bytes_usage

number | null

Die Gesamtzahl der von dieser Assembly verarbeiteten Bytes, die auf Ihre Nutzungskosten angerechnet werden. Die Summe von bytes_usage all Ihrer Assemblies entspricht Ihrer monatlichen Gesamtnutzung.

client_agent

null | string

Der User-Agent des Uploaders wird nicht offengelegt; dieses veraltete Feld ist immer null.

client_ip

null | string

Die IP-Adresse des Uploaders wird nicht offengelegt; dieses veraltete Feld ist immer null.

client_referer

null | string

Die Referrer-URL des Uploaders wird nicht offengelegt; dieses veraltete Feld ist immer null.

companion_url

null | string

Die URL des Companion-Servers, mit dem diese Assembly gegebenenfalls kommuniziert.

executing_jobs

Array<string>

Schema eines Array-Elements

string

execution_duration

number | null

Die Zeit in Sekunden, die Transloadit zum Ausführen dieser Assembly benötigt hat.

execution_start

null | string

expected_tus_uploads

number

fields

object

Eine Schlüssel-Wert-Zuordnung aller zusätzlichen Felder in Ihrem Formular für Integrationen, die keine Kapselung mit <form> verwenden können (wie Uppy).

Schema für zusätzliche Eigenschaften

beliebiger Wert

finished_tus_uploads

number

has_dupe_jobs

boolean

ignored_error_count

number

ignored_errors

Array<object>

Schema eines Array-Elements

object

ignored_errors[]: Die Antwort kann zusätzliche Felder enthalten.

Feld	Typ und Beschreibung
`ignored_errors[].error`	`beliebiger Wert`
`ignored_errors[].message`	`string`
`ignored_errors[].phase`	`string`
`ignored_errors[].step`	`null \| string`

info

object

info: Die Antwort kann zusätzliche Felder enthalten.

info.retryIn

number

instance

null | string

is_infinite

boolean

jobs_queue_duration

number

last_job_completed

null | string

merged_params

null | string

message

string

Eine für Menschen verständliche Meldung, die den Status dieser Assembly erläutert. Sie ist nicht immer vorhanden.

notify_duration

number | null

Verstrichene Zustellzeit in Sekunden, einschließlich automatischer Wiederholungsversuche und der Verzögerungen dazwischen.

notify_error

null | string

notify_response_code

number | null

notify_response_data

null | string

null | string

null | string

null | string

number

params

null | string

parent_assembly_status

beliebiger Wert | null

Eines der folgenden Schemas kann gelten:

beliebiger Wert

beliebiger Wert

null

null

parent_id

null | string

previousStep

string

Name des vorhergehenden Steps, der mit dem Fehler zusammenhängt, sofern verfügbar.

queue_duration

number

region

string

results

object

Die Ergebnisdateien, die Transloadit bisher erstellt hat. Jeder Schlüssel dieses Objekts ist der Name des Steps, der eine bestimmte Datei erstellt hat. Da Storage-Robots keine Dateien erstellen, sind die Namen ihrer Steps hier nicht enthalten. Im Fall eines error können Teilergebnisse enthalten sein.

Schema für zusätzliche Eigenschaften

Array<object>

Weitere Schemadetails finden Sie im vollständigen JSON Schema.

running_jobs

Array<string>

Schema eines Array-Elements

string

start_date

string

Datum und Uhrzeit, zu denen der Upload für diese Assembly gestartet wurde.

started_jobs

Array<string>

Schema eines Array-Elements

string

started_tus_uploads

number

step

string

Name des Steps, der mit dem Fehler zusammenhängt, sofern verfügbar.

null | string

null | string

null | string

null | string

Array<object>

Schema eines Array-Elements

object

tus_uploads[]: Die Antwort kann zusätzliche Felder enthalten.

Feld	Typ und Beschreibung
`tus_uploads[].fieldname` erforderlich	`string`
`tus_uploads[].filename` erforderlich	`string`
`tus_uploads[].finished` erforderlich	`boolean`
`tus_uploads[].offset` erforderlich	`number`
`tus_uploads[].size` erforderlich	`number`
`tus_uploads[].upload_url` erforderlich	`string`
`tus_uploads[].user_meta`	`object` Weitere Schemadetails finden Sie im vollständigen JSON Schema.

tus_url

string

Die URL des tus-Servers, den diese Assembly für fortsetzbare Uploads verwendet.

update_stream_url

null | string

Die URL eines Server-Sent-Events-Streams, über den Sie Echtzeit-Statusaktualisierungen zu dieser Assembly erhalten können.

upload_duration

number

Die Zeit in Sekunden, die der Uploader zum Hochladen der Dateien benötigt hat.

upload_meta_data_extracted

boolean

uploads

Array<object>

Ein Array der für diese Assembly hochgeladenen Dateien. Weitere Informationen finden Sie in der Metadaten-Dokumentation.

Schema eines Array-Elements

object

Feld	Typ und Beschreibung
`uploads[].as`	`string \| Array<string> \| null` Weitere Schemadetails finden Sie im vollständigen JSON Schema.
`uploads[].cost`	`number \| null`
`uploads[].exec_time`	`number`
`uploads[].from_batch_import`	`boolean`
`uploads[].import_url`	`string`
`uploads[].is_temp_url`	`boolean`
`uploads[].is_tus_file`	`boolean`
`uploads[].md5hash`	`null \| string`
`uploads[].original_basename`	`null \| string`
`uploads[].original_id` erforderlich	`string \| Array<null \| string>` Die eindeutige ID der ursprünglich hochgeladenen Datei, aus der diese Datei erzeugt wurde. Damit können Sie auch nach mehreren Steps der Verarbeitung bestimmen, welche Datei eines Uploads mit mehreren Dateien zur Erzeugung einer bestimmten Datei verwendet wurde. Weitere Schemadetails finden Sie im vollständigen JSON Schema.
`uploads[].original_md5hash`	`null \| string`
`uploads[].original_name`	`null \| string`
`uploads[].original_path`	`string`
`uploads[].queue`	`null \| string`
`uploads[].queue_time`	`number`
`uploads[].ssl_url`	`null \| string`
`uploads[].tus_upload_url`	`null \| string`
`uploads[].user_meta`	`object` Weitere Schemadetails finden Sie im vollständigen JSON Schema.

Eines der folgenden Schemas kann gelten:

erforderliche Eigenschaften: basename, ext, field, id, meta, mime, name, size, type, url: object

object

uploads[]: Die Antwort kann zusätzliche Felder enthalten.

Feld	Typ und Beschreibung
`uploads[].basename` erforderlich	`null \| string` Der Name der Datei ohne die Dateierweiterung.
`uploads[].ext` erforderlich	`string` Die Erweiterung der Datei.
`uploads[].field` erforderlich	`null \| string` Der Name des Formularfelds, über das diese Datei übermittelt wurde.
`uploads[].id` erforderlich	`string` Eine zufällige, eindeutige ID, die Transloadit intern zur Nachverfolgung der Datei verwendet.
`uploads[].meta` erforderlich	`object` Ein Objekt mit zusätzlichen Metadaten, die aus der Datei extrahiert wurden, wie unten dargestellt. Weitere Schemadetails finden Sie im vollständigen JSON Schema.
`uploads[].mime` erforderlich	`null \| string` Der ermittelte MIME-Typ dieser Datei.
`uploads[].name` erforderlich	`null \| string` Der Name der Datei. Transloadit ändert die Erweiterung in diesem Feld, wenn die Datei durch Verarbeitung in ein anderes Format umgewandelt wird.
`uploads[].size` erforderlich	`number` Die Größe der Datei in Bytes.
`uploads[].type` erforderlich	`null \| string` Eine abstrakte Kategorie zur Beschreibung der Datei. Bekannte Werte sind `"audio"`, `"document"`, `"image"`, `"office"`, `"pdf"`, `"swf"`, `"video"`, `"xls"` oder `null`, wenn keine Kategorie erkannt wurde. Clients sollten weitere Zeichenfolgen akzeptieren, damit zukünftige Kategorien kompatibel bleiben.
`uploads[].url` erforderlich	`null \| string` Eine URL, über die die Datei heruntergeladen werden kann, oder `null`, wenn keine Auslieferungs-URL verfügbar ist. Temporäre URLs auf unseren Servern laufen nach einigen Stunden ab; exportieren Sie Dateien zur späteren Verwendung in einen Speicher. Ergebnisse aus privatem Speicher von `/transloadit/store` geben sowohl für `url` als auch für `ssl_url` den Wert `null` zurück. Bewahren Sie die zurückgegebene `asset_id` für DAM-Operationen und den zurückgegebenen `path` für `/transloadit/import` auf. Aktualisieren Sie den gespeicherten Pfad, wenn Sie das Asset verschieben oder umbenennen; weder eine temporäre URL noch die `id` der verarbeiteten Datei ist eine dauerhafte Speicherreferenz.

Variante 2: object

object

uploads[]: Die Antwort kann zusätzliche Felder enthalten.

Feld	Typ und Beschreibung
`uploads[].basename`	`null \| string` Der Name der Datei ohne die Dateierweiterung.
`uploads[].ext`	`string` Die Erweiterung der Datei.
`uploads[].field`	`null \| string` Der Name des Formularfelds, über das diese Datei übermittelt wurde.
`uploads[].id`	`nie` Dieser Wert ist unzulässig.
`uploads[].meta`	`object` Ein Objekt mit zusätzlichen Metadaten, die aus der Datei extrahiert wurden, wie unten dargestellt. Weitere Schemadetails finden Sie im vollständigen JSON Schema.
`uploads[].mime`	`null \| string` Der ermittelte MIME-Typ dieser Datei.
`uploads[].name`	`null \| string` Der Name der Datei. Transloadit ändert die Erweiterung in diesem Feld, wenn die Datei durch Verarbeitung in ein anderes Format umgewandelt wird.
`uploads[].size`	`number` Die Größe der Datei in Bytes.
`uploads[].type`	`null \| string` Eine abstrakte Kategorie zur Beschreibung der Datei. Bekannte Werte sind `"audio"`, `"document"`, `"image"`, `"office"`, `"pdf"`, `"swf"`, `"video"`, `"xls"` oder `null`, wenn keine Kategorie erkannt wurde. Clients sollten weitere Zeichenfolgen akzeptieren, damit zukünftige Kategorien kompatibel bleiben.
`uploads[].url`	`null \| string` Eine URL, über die die Datei heruntergeladen werden kann, oder `null`, wenn keine Auslieferungs-URL verfügbar ist. Temporäre URLs auf unseren Servern laufen nach einigen Stunden ab; exportieren Sie Dateien zur späteren Verwendung in einen Speicher. Ergebnisse aus privatem Speicher von `/transloadit/store` geben sowohl für `url` als auch für `ssl_url` den Wert `null` zurück. Bewahren Sie die zurückgegebene `asset_id` für DAM-Operationen und den zurückgegebenen `path` für `/transloadit/import` auf. Aktualisieren Sie den gespeicherten Pfad, wenn Sie das Asset verschieben oder umbenennen; weder eine temporäre URL noch die `id` der verarbeiteten Datei ist eine dauerhafte Speicherreferenz.

null | string

string

string

Array<object>

Schema eines Array-Elements

object

warnings[]: Die Antwort kann zusätzliche Felder enthalten.

Feld	Typ und Beschreibung
`warnings[].action`	`object` (erforderliche Eigenschaften: message, text, type) Weitere Schemadetails finden Sie im vollständigen JSON Schema.
`warnings[].level` erforderlich	`"notice" \| "warning"`
`warnings[].msg` erforderlich	`string`

websocket_url

null | string

Die URL eines Websocket-Servers (verwendet Socket.IO), von dem Sie Echtzeit-Statusaktualisierungen zu dieser Assembly erhalten können.

Eines der folgenden Schemas kann gelten:

ok: "ASSEMBLY_EXECUTING" | "ASSEMBLY_REPLAYING" | "ASSEMBLY_UPLOADING"

Die Antwort kann zusätzliche Felder enthalten.

Feld	Typ und Beschreibung
`error`	`nie` Zeigt einen Fehlerstatus an. Dieser Schlüssel ist nur vorhanden, wenn die Assembly fehlgeschlagen ist. Dieser Wert ist unzulässig.
`ok` erforderlich	`"ASSEMBLY_EXECUTING" \| "ASSEMBLY_REPLAYING" \| "ASSEMBLY_UPLOADING"` Zeigt einen Lebenszyklusstatus ohne Fehler an, einschließlich Hochladen, Ausführen, abgebrochener Anfragen und stornierter Assemblies. Erfolgreiche Verarbeitung wird durch `ASSEMBLY_COMPLETED` angezeigt. Wenn bei der Assembly ein Fehler aufgetreten ist, wird stattdessen der unten beschriebene Schlüssel `error` verwendet.

Die Antwort kann zusätzliche Felder enthalten.

Feld Typ und Beschreibung

error

nie

Zeigt einen Fehlerstatus an. Dieser Schlüssel ist nur vorhanden, wenn die Assembly fehlgeschlagen ist.

Dieser Wert ist unzulässig.

ok

erforderlich

"ASSEMBLY_CANCELED" | "ASSEMBLY_COMPLETED" | "ASSEMBLY_EXECUTING" | "ASSEMBLY_REPLAYING" | "ASSEMBLY_UPLOADING" | "REQUEST_ABORTED"

Zeigt einen Lebenszyklusstatus ohne Fehler an, einschließlich Hochladen, Ausführen, abgebrochener Anfragen und stornierter Assemblies. Erfolgreiche Verarbeitung wird durch ASSEMBLY_COMPLETED angezeigt. Wenn bei der Assembly ein Fehler aufgetreten ist, wird stattdessen der unten beschriebene Schlüssel error verwendet.

erforderliche Eigenschaften: error

Die Antwort kann zusätzliche Felder enthalten.

Feld	Typ und Beschreibung
`cmd`	`string \| Array<string \| number>` Optionale Details zum Verarbeitungsbefehl für die Fehlerbehebung. Diagnosedetails können variieren; verwenden Sie für die programmgesteuerte Fehlerbehandlung den `error`-Code. Eines der folgenden Schemas kann gelten: string `string` Array<string \| number> `Array<string \| number>` Schema eines Array-Elements `string \| number`
`error` erforderlich	"ADMIN_PERMISSIONS_REQUIRED" \| "AI_CHAT_VALIDATION" \| "ASSEMBLY_ACCOUNT_MISMATCH" \| "ASSEMBLY_CANNOT_BE_REPLAYED" \| "ASSEMBLY_COULD_NOT_BE_CREATED" \| "ASSEMBLY_CRASHED" \| "ASSEMBLY_DISALLOWED_ROBOTS_USED" \| "ASSEMBLY_EMPTY_STEPS" \| "ASSEMBLY_EXECUTION_PROGRESS_NOT_ENABLED" \| "ASSEMBLY_EXPIRED" \| "ASSEMBLY_FILE_NOT_RESERVED" \| "ASSEMBLY_INFINITE" \| "ASSEMBLY_INVALID_NOTIFY_URL" \| "ASSEMBLY_INVALID_NUM_EXPECTED_UPLOAD_FILES_PARAM" \| "ASSEMBLY_INVALID_STEPS" \| "ASSEMBLY_JOB_ENQUEUE_ERROR" \| "ASSEMBLY_LIST_ERROR" \| "ASSEMBLY_MEMORY_LIMIT_EXCEEDED" \| "ASSEMBLY_NOTIFICATIONS_LIST_ERROR" \| "ASSEMBLY_NOTIFICATION_LIST_ERROR" \| "ASSEMBLY_NOTIFICATION_NOT_PERSISTED" \| "ASSEMBLY_NOTIFICATION_NOT_REPLAYED" \| "ASSEMBLY_NOT_CAPABLE" \| "ASSEMBLY_NOT_FINISHED" \| "ASSEMBLY_NOT_FOUND" \| "ASSEMBLY_NOT_REPLAYED" \| "ASSEMBLY_NO_CHARGEABLE_STEP" \| "ASSEMBLY_NO_NOTIFY_URL" \| "ASSEMBLY_NO_STEPS" \| "ASSEMBLY_PLAN_FILE_SIZE_LIMIT_EXCEEDED" \| "ASSEMBLY_ROBOT_MISSING" \| "ASSEMBLY_SATURATED" \| "ASSEMBLY_STATS_ERROR" \| "ASSEMBLY_STATS_INVALID_TIME" \| "ASSEMBLY_STATS_MISSING_REGION" \| "ASSEMBLY_STATUS_FETCHING_RATE_LIMIT_REACHED" \| "ASSEMBLY_STATUS_NOT_FOUND" \| "ASSEMBLY_STATUS_PARSE_ERROR" \| "ASSEMBLY_STEP_INVALID" \| "ASSEMBLY_STEP_INVALID_ROBOT" \| "ASSEMBLY_STEP_INVALID_USE" \| "ASSEMBLY_STEP_NO_ROBOT" \| "ASSEMBLY_STEP_UNKNOWN_ROBOT" \| "ASSEMBLY_STEP_UNKNOWN_USE" \| "ASSEMBLY_URL_TRANSFORM_MISSING" \| "AUDIO_ARTWORK_VALIDATION" \| "AUDIO_CONCAT_INVALID_INPUT" \| "AUDIO_CONCAT_VALIDATION" \| "AUDIO_ENCODE_VALIDATION" \| "AUDIO_LOOP_VALIDATION" \| "AUDIO_MERGE_VALIDATION" \| "AUDIO_SPLIT_NO_OUTPUT" \| "AUDIO_SPLIT_VALIDATION" \| "AUDIO_WAVEFORM_VALIDATION" \| "AUTH_EXPIRED" \| "AUTH_KEYS_NOT_FOUND" \| "AUTH_KEY_SCOPES_NOT_FOUND" \| "AUTH_SECRET_NOT_RETRIEVED" \| "AZURE_IMPORT_ACCESS_DENIED" \| "AZURE_IMPORT_FAILURE" \| "AZURE_IMPORT_NOT_FOUND" \| "AZURE_IMPORT_VALIDATION" \| "AZURE_STORE_ACCESS_DENIED" \| "AZURE_STORE_NOT_FOUND" \| "AZURE_STORE_VALIDATION" \| "BACKBLAZE_IMPORT_ACCESS_DENIED" \| "BACKBLAZE_IMPORT_FAILURE" \| "BACKBLAZE_IMPORT_NOT_FOUND" \| "BACKBLAZE_IMPORT_VALIDATION" \| "BACKBLAZE_STORE_ACCESS_DENIED" \| "BACKBLAZE_STORE_FAILURE" \| "BACKBLAZE_STORE_VALIDATION" \| "BAD_PRICING" \| "BEARER_TOKEN_AUTH_KEY_MISMATCH" \| "BEARER_TOKEN_EXPIRED" \| "BEARER_TOKEN_INVALID" \| "BILL_LIMIT_EXCEEDED" \| "BOX_IMPORT_ACCESS_DENIED" \| "BOX_IMPORT_FAILURE" \| "BOX_IMPORT_NOT_FOUND" \| "BOX_IMPORT_VALIDATION" \| "BOX_STORE_COULD_NOT_PARSE_URL" \| "BOX_STORE_VALIDATION" \| "CANNOT_ACCEPT_NEW_ASSEMBLIES" \| "CDN_REQUIRED" \| "CLOUDFILES_IMPORT_ACCESS_DENIED" \| "CLOUDFILES_IMPORT_FAILURE" \| "CLOUDFILES_IMPORT_NOT_FOUND" \| "CLOUDFILES_IMPORT_VALIDATION" \| "CLOUDFILES_STORE_ACCESS_DENIED" \| "CLOUDFILES_STORE_ERROR" \| "CLOUDFILES_STORE_VALIDATION" \| "CLOUDFLARE_IMPORT_ACCESS_DENIED" \| "CLOUDFLARE_IMPORT_FAILURE" \| "CLOUDFLARE_IMPORT_NOT_FOUND" \| "CLOUDFLARE_IMPORT_VALIDATION" \| "CLOUDFLARE_STORE_ACCESS_DENIED" \| "CLOUDFLARE_STORE_NOT_FOUND" \| "CLOUDFLARE_STORE_URL_VERIFICATION_FAILURE" \| "CLOUDFLARE_STORE_VALIDATION" \| "CLOUDFLARE_STORE_WRONG_REGION" \| "CLOUD_AI_IMAGE_VALIDATION" \| "DIGITALOCEAN_IMPORT_ACCESS_DENIED" \| "DIGITALOCEAN_IMPORT_FAILURE" \| "DIGITALOCEAN_IMPORT_NOT_FOUND" \| "DIGITALOCEAN_IMPORT_VALIDATION" \| "DIGITALOCEAN_STORE_ACCESS_DENIED" \| "DIGITALOCEAN_STORE_NOT_FOUND" \| "DIGITALOCEAN_STORE_VALIDATION" \| "DIGITALOCEAN_STORE_WRONG_REGION" \| "DOCUMENT_AUTOROTATE_VALIDATION" \| "DOCUMENT_CONVERT_UNSUPPORTED_CONVERSION" \| "DOCUMENT_CONVERT_VALIDATION" \| "DOCUMENT_EXTRACT_VALIDATION" \| "DOCUMENT_MERGE_UNSUPPORTED_CONVERSION" \| "DOCUMENT_MERGE_VALIDATION" \| "DOCUMENT_OCR_VALIDATION" \| "DOCUMENT_OPTIMIZE_UNSUPPORTED_INPUT" \| "DOCUMENT_OPTIMIZE_VALIDATION" \| "DOCUMENT_SPLIT_VALIDATION" \| "DOCUMENT_THUMBS_INVALID_INPUT" \| "DOCUMENT_THUMBS_VALIDATION" \| "DO_NOT_REUSE_ASSEMBLY_IDS" \| "DROPBOX_IMPORT_ACCESS_DENIED" \| "DROPBOX_IMPORT_FAILURE" \| "DROPBOX_IMPORT_NOT_FOUND" \| "DROPBOX_IMPORT_VALIDATION" \| "DROPBOX_STORE_COULD_NOT_PARSE_URL" \| "DROPBOX_STORE_VALIDATION" \| "FILE_COMPRESS_INVALID_INPUT" \| "FILE_COMPRESS_VALIDATION" \| "FILE_DECOMPRESS_INVALID_INPUT" \| "FILE_DECOMPRESS_PASSWORD_INCORRECT" \| "FILE_DECOMPRESS_PASSWORD_REQUIRED" \| "FILE_DECOMPRESS_VALIDATION" \| "FILE_DOWNLOAD_ERROR" \| "FILE_FILTER_DECLINED_FILE" \| "FILE_FILTER_INVALID_OPERATOR" \| "FILE_FILTER_VALIDATION" \| "FILE_HASH_VALIDATION" \| "FILE_META_DATA_ERROR" \| "FILE_PREVIEW_VALIDATION" \| "FILE_READ_VALIDATION_ERROR" \| "FILE_SERVE_NO_RESULT" \| "FILE_SERVE_VALIDATION" \| "FILE_VERIFY_INVALID_FILE" \| "FILE_VERIFY_VALIDATION" \| "FILE_VIRUSSCAN_DECLINED_FILE" \| "FILE_VIRUSSCAN_INVALID_INPUT" \| "FILE_VIRUSSCAN_VALIDATION" \| "FTP_IMPORT_ACCESS_DENIED" \| "FTP_IMPORT_FAILURE" \| "FTP_IMPORT_NOT_FOUND" \| "FTP_IMPORT_VALIDATION" \| "FTP_STORE_VALIDATION" \| "GET_ACCOUNT_DB_ERROR" \| "GET_ACCOUNT_UNKNOWN_AUTH_KEY" \| "GOOGLE_IMPORT_ACCESS_DENIED" \| "GOOGLE_IMPORT_FAILURE" \| "GOOGLE_IMPORT_NOT_FOUND" \| "GOOGLE_IMPORT_VALIDATION" \| "GOOGLE_STORE_INVALID_INPUT" \| "GOOGLE_STORE_VALIDATION" \| "HTML_CONVERT_VALIDATION" \| "HTTP_IMPORT_ACCESS_DENIED" \| "HTTP_IMPORT_FAILURE" \| "HTTP_IMPORT_NOT_FOUND" \| "HTTP_IMPORT_VALIDATION" \| "HTTP_REQUEST_FAILURE" \| "HTTP_REQUEST_VALIDATION" \| "IMAGE_BGREMOVE_VALIDATION" \| "IMAGE_COPYRIGHT_DETECT_DECLINED_FILE" \| "IMAGE_COPYRIGHT_DETECT_VALIDATION" \| "IMAGE_DESCRIBE_VALIDATION" \| "IMAGE_ENHANCE_NO_INPUT_FILE" \| "IMAGE_ENHANCE_VALIDATION" \| "IMAGE_FACEDETECT_VALIDATION" \| "IMAGE_GENERATE_VALIDATION" \| "IMAGE_MERGE_FAILURE" \| "IMAGE_MERGE_VALIDATION" \| "IMAGE_OCR_VALIDATION" \| "IMAGE_OPTIMIZE_VALIDATION" \| "IMAGE_RESIZE_ERROR" \| "IMAGE_RESIZE_INVALID_BLUR_REGION" \| "IMAGE_RESIZE_INVALID_TEXT_OBJECT_VALUE" \| "IMAGE_RESIZE_INVALID_TEXT_VALUE" \| "IMAGE_RESIZE_INVALID_WATERMARK_OFFSET" \| "IMAGE_RESIZE_INVALID_WATERMARK_POSITION" \| "IMAGE_RESIZE_NO_CLUT_FILE" \| "IMAGE_RESIZE_NO_INPUT_FILE" \| "IMAGE_RESIZE_VALIDATION" \| "IMAGE_UPSCALE_VALIDATION" \| "IMPORT_FILE_ERROR" \| "INCOMPLETE_PRICING" \| "INSUFFICIENT_AUTH_SCOPE" \| "INTERNAL_COMMAND_ERROR" \| "INTERNAL_COMMAND_TIMEOUT" \| "INVALID_ASSEMBLY_STATUS" \| "INVALID_AUTH_EXPIRES_PARAMETER" \| "INVALID_AUTH_KEY_PARAMETER" \| "INVALID_AUTH_MAX_NUMBER_OF_FILES_PARAMETER" \| "INVALID_AUTH_MAX_SIZE_PARAMETER" \| "INVALID_AUTH_REFERER_PARAMETER" \| "INVALID_FILE_META_DATA" \| "INVALID_FORM_DATA" \| "INVALID_INPUT_ERROR" \| "INVALID_PARAMS_FIELD" \| "INVALID_SIGNATURE" \| "INVALID_STEP_NAME" \| "INVALID_TEMPLATE_FIELD" \| "INVALID_UPLOAD_HANDLE_STEP_NAME" \| "INVALID_URL_ENCODING" \| "MAX_NUMBER_OF_FILES_EXCEEDED" \| "MAX_SIZE_EXCEEDED" \| "MEGA_IMPORT_ACCESS_DENIED" \| "MEGA_IMPORT_FAILURE" \| "MEGA_IMPORT_NOT_FOUND" \| "MEGA_IMPORT_VALIDATION" \| "MEGA_STORE_ACCESS_DENIED" \| "MEGA_STORE_NOT_FOUND" \| "MEGA_STORE_VALIDATION" \| "MEGA_STORE_WRONG_REGION" \| "META_WRITE_VALIDATION" \| "MINIO_IMPORT_ACCESS_DENIED" \| "MINIO_IMPORT_FAILURE" \| "MINIO_IMPORT_NOT_FOUND" \| "MINIO_IMPORT_VALIDATION" \| "MINIO_STORE_ACCESS_DENIED" \| "MINIO_STORE_NOT_FOUND" \| "MINIO_STORE_VALIDATION" \| "MINIO_STORE_WRONG_REGION" \| "NO_AUTH_EXPIRES_PARAMETER" \| "NO_AUTH_KEY_PARAMETER" \| "NO_AUTH_PARAMETER" \| "NO_COUNTRY" \| "NO_OBJECT_AUTH_PARAMETER" \| "NO_OBJECT_PARAMS_FIELD" \| "NO_PARAMS_FIELD" \| "NO_PRICING" \| "NO_RESULT_STEP_FOUND" \| "NO_RPC_RESULT_FROM_IMAGE_RESIZER" \| "NO_SIGNATURE_FIELD" \| "NO_TEMPLATE_ID" \| "PLAN_LIMIT_EXCEEDED" \| "POSSIBLY_MALICIOUS_FILE_FOUND" \| "PRIORITY_JOB_SLOTS_NOT_FOUND" \| "PRIORITY_JOB_SLOT_STATS_ERROR" \| "PRIORITY_JOB_SLOT_STATS_INVALID_AGGREGATION" \| "PRIORITY_JOB_SLOT_STATS_INVALID_TIME" \| "PRIORITY_JOB_SLOT_STATS_MISSING_REGION" \| "RATE_LIMIT_REACHED" \| "REFERER_MISMATCH" \| "REQUEST_PREMATURE_CLOSED" \| "ROBOT_VALIDATION_BASE_ERROR" \| "S3_ACCESS_DENIED" \| "S3_IMPORT_ACCESS_DENIED" \| "S3_IMPORT_FAILURE" \| "S3_IMPORT_NOT_FOUND" \| "S3_IMPORT_VALIDATION" \| "S3_NOT_FOUND" \| "S3_STORE_ACCESS_DENIED" \| "S3_STORE_FAILURE" \| "S3_STORE_NOT_FOUND" \| "S3_STORE_URL_VERIFICATION_FAILURE" \| "S3_STORE_VALIDATION" \| "S3_STORE_WRONG_REGION" \| "S3_WRONG_REGION" \| "SCRIPT_RUN_VALIDATION" \| "SERVER_403" \| "SERVER_404" \| "SERVER_500" \| "SFTP_IMPORT_ACCESS_DENIED" \| "SFTP_IMPORT_FAILURE" \| "SFTP_IMPORT_NOT_FOUND" \| "SFTP_IMPORT_VALIDATION" \| "SFTP_STORE_VALIDATION" \| "SIGNATURE_REUSE_DETECTED" \| "SPEECH_TRANSCRIBE_VALIDATION" \| "STORAGE_GRANT_NOT_CREATED" \| "SUPABASE_IMPORT_ACCESS_DENIED" \| "SUPABASE_IMPORT_FAILURE" \| "SUPABASE_IMPORT_NOT_FOUND" \| "SUPABASE_IMPORT_VALIDATION" \| "SUPABASE_STORE_ACCESS_DENIED" \| "SUPABASE_STORE_NOT_FOUND" \| "SUPABASE_STORE_VALIDATION" \| "SUPABASE_STORE_WRONG_REGION" \| "SWIFT_IMPORT_ACCESS_DENIED" \| "SWIFT_IMPORT_FAILURE" \| "SWIFT_IMPORT_NOT_FOUND" \| "SWIFT_IMPORT_VALIDATION" \| "SWIFT_STORE_ACCESS_DENIED" \| "SWIFT_STORE_NOT_FOUND" \| "SWIFT_STORE_VALIDATION" \| "SWIFT_STORE_WRONG_REGION" \| "TEMPLATE_CREDENTIALS_INJECTION_ERROR" \| "TEMPLATE_DB_ERROR" \| "TEMPLATE_DENIES_STEPS_OVERRIDE" \| "TEMPLATE_INVALID_JSON" \| "TEMPLATE_NOT_FOUND" \| "TEXT_SPEAK_VALIDATION" \| "TEXT_TRANSLATE_VALIDATION" \| "TIGRIS_IMPORT_ACCESS_DENIED" \| "TIGRIS_IMPORT_FAILURE" \| "TIGRIS_IMPORT_NOT_FOUND" \| "TIGRIS_IMPORT_VALIDATION" \| "TIGRIS_STORE_ACCESS_DENIED" \| "TIGRIS_STORE_NOT_FOUND" \| "TIGRIS_STORE_VALIDATION" \| "TIGRIS_STORE_WRONG_REGION" \| "TMP_FILE_DOWNLOAD_ERROR" \| "TOKEN_INVALID_CREDENTIALS" \| "TRANSIENT_STORAGE_SERVICE_ERROR" \| "TRANSLOADIT_IMPORT_ACCESS_DENIED" \| "TRANSLOADIT_IMPORT_FAILURE" \| "TRANSLOADIT_IMPORT_NOT_FOUND" \| "TRANSLOADIT_IMPORT_VALIDATION" \| "TRANSLOADIT_STORE_CONFLICT" \| "TRANSLOADIT_STORE_FAILURE" \| "TRANSLOADIT_STORE_UNAVAILABLE" \| "TRANSLOADIT_STORE_VALIDATION" \| "TUS_STORE_VALIDATION" \| "USER_COMMAND_ERROR" \| "VERIFIED_EMAIL_REQUIRED" \| "VIDEO_ADAPTIVE_VALIDATION" \| "VIDEO_ARTWORK_VALIDATION" \| "VIDEO_CONCAT_INVALID_INPUT" \| "VIDEO_CONCAT_NO_OUTPUT" \| "VIDEO_CONCAT_VALIDATION" \| "VIDEO_ENCODE_INVALID_VIDEO_CODEC" \| "VIDEO_ENCODE_INVALID_WATERMARK_POSITION" \| "VIDEO_ENCODE_VALIDATION" \| "VIDEO_GENERATE_VALIDATION" \| "VIDEO_MERGE_NO_IMAGE_FOUND" \| "VIDEO_MERGE_VALIDATION" \| "VIDEO_ONDEMAND_NOT_FOUND" \| "VIDEO_ONDEMAND_VALIDATION" \| "VIDEO_SPLIT_NO_OUTPUT" \| "VIDEO_SPLIT_VALIDATION" \| "VIDEO_SUBTITLE_VALIDATION" \| "VIDEO_THUMBS_INVALID_COUNT_VALUE" \| "VIDEO_THUMBS_INVALID_FORMAT" \| "VIDEO_THUMBS_INVALID_INPUT" \| "VIDEO_THUMBS_VALIDATION" \| "VIMEO_IMPORT_ACCESS_DENIED" \| "VIMEO_IMPORT_FAILURE" \| "VIMEO_IMPORT_NOT_FOUND" \| "VIMEO_IMPORT_VALIDATION" \| "VIMEO_STORE_ACCESS_DENIED" \| "VIMEO_STORE_PROBLEM_SENDING_FILE" \| "VIMEO_STORE_VALIDATION" \| "WASABI_IMPORT_ACCESS_DENIED" \| "WASABI_IMPORT_FAILURE" \| "WASABI_IMPORT_NOT_FOUND" \| "WASABI_IMPORT_VALIDATION" \| "WASABI_STORE_ACCESS_DENIED" \| "WASABI_STORE_NOT_FOUND" \| "WASABI_STORE_VALIDATION" \| "WASABI_STORE_WRONG_REGION" \| "WORKER_JOB_ERROR" \| "YOUTUBE_STORE_PROBLEM_SENDING_FILE" \| "YOUTUBE_STORE_VALIDATION" Zeigt einen Fehlerstatus an. Dieser Schlüssel ist nur vorhanden, wenn die Assembly fehlgeschlagen ist.
`exitCode`	`number \| null` Optionaler Exit-Status eines fehlgeschlagenen Verarbeitungsbefehls. Diagnosedetails können variieren; verwenden Sie für die programmgesteuerte Fehlerbehandlung den `error`-Code.
`exitSignal`	`null \| string` Optionales Signal, das einen Verarbeitungsbefehl beendet hat. Diagnosedetails können variieren; verwenden Sie für die programmgesteuerte Fehlerbehandlung den `error`-Code.
`file`	`string`
`headers`	`object` Schema für zusätzliche Eigenschaften `beliebiger Wert`
`is_private_address`	`boolean`
`name`	`string`
`numRetries`	`number`
`ok`	`null`
`playwright_error_code`	`string`
`reason`	`string` Optionale Erklärung des Fehlers. Diagnosedetails können variieren; verwenden Sie für die programmgesteuerte Fehlerbehandlung den `error`-Code.
`response_code`	`number \| null`
`retries`	`number`
`retryable`	`boolean`
`stderr`	`string` Optionale Diagnoseausgabe eines Verarbeitungsbefehls zur Fehlerbehebung. Diagnosedetails können variieren; verwenden Sie für die programmgesteuerte Fehlerbehandlung den `error`-Code.
`stdout`	`string` Optionale Standardausgabe eines Verarbeitungsbefehls zur Fehlerbehebung. Diagnosedetails können variieren; verwenden Sie für die programmgesteuerte Fehlerbehandlung den `error`-Code.
`url`	`string`
`url_host`	`null \| string`

Fehlerantwort

JSON-Response-Body. application/json text/plain; charset=utf-8

Schema des Response-Bodys

Vollständiges JSON Schema

JSON in einem neuen Tab öffnen

Mindestens eine dieser Eigenschaften ist erforderlich: error, message, reason

Die Antwort kann zusätzliche Felder enthalten.

Feld	Typ und Beschreibung
`assembly_id`	`string`
`error`	`string` (minimale Länge: 1)
`http_code`	`number \| string` `number` `string` Validierungsmuster (regulärer Ausdruck) ^[\x09-\x0D\x20\xA0\u1680\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200a\u2028\u2029\u202f\u205f\u3000\ufeff][+-]?0(?:0(?:[^0-9]\|$)\|(?:[1-9][0-9]{0,307}\|1(?:(?:[0-6][0-9]{7}\|7[0-8][0-9]{6}\|79[0-6][0-9]{5}\|797[0-5][0-9]{4}\|7976[0-8][0-9]{3}\|79769[0-2][0-9]{2}\|7976930[0-9]{1}\|7976931[0-2])[0-9]{300}\|79769313(?:(?:[0-3][0-9]{7}\|4[0-7][0-9]{6}\|48[0-5][0-9]{5}\|486[0-1][0-9]{4}\|4862[0-2][0-9]{3}\|486230[0-9]{2}\|486231[0-4][0-9]{1}\|4862315[0-7])[0-9]{292}\|48623158(?:(?:0[0-6][0-9]{6}\|07[0-8][0-9]{5}\|079[0-2][0-9]{4}\|0793[0-6][0-9]{3}\|07937[0-1][0-9]{2}\|079372[0-7][0-9]{1}\|0793728[0-8])[0-9]{284}\|07937289(?:(?:[0-6][0-9]{7}\|70[0-9]{6}\|71[0-3][0-9]{5}\|7140[0-4][0-9]{3}\|71405[0-2][0-9]{2}\|7140530[0-2])[0-9]{276}\|71405303(?:(?:[0-3][0-9]{7}\|40[0-9]{6}\|41[0-4][0-9]{5}\|4150[0-6][0-9]{3}\|41507[0-8][0-9]{2}\|415079[0-8][0-9]{1}\|4150799[0-2])[0-9]{268}\|41507993(?:(?:[0-3][0-9]{7}\|40[0-9]{6}\|41[0-2][0-9]{5}\|413[0-1][0-9]{4}\|4132[0-6][0-9]{3}\|413270[0-9]{2})[0-9]{260}\|41327100(?:(?:[0-2][0-9]{7}\|3[0-6][0-9]{6}\|37[0-7][0-9]{5}\|378[0-1][0-9]{4}\|3782[0-5][0-9]{3}\|37826[0-8][0-9]{2}\|378269[0-2][0-9]{1}\|3782693[0-5])[0-9]{252}\|37826936(?:(?:0[0-9]{7}\|1[0-6][0-9]{6}\|17[0-2][0-9]{5}\|173[0-6][0-9]{4}\|1737[0-6][0-9]{3}\|17377[0-7][0-9]{2}\|173778[0-8][0-9]{1}\|1737789[0-7])[0-9]{244}\|17377898(?:(?:0[0-3][0-9]{6}\|04[0-3][0-9]{5}\|044[0-3][0-9]{4}\|0444[0-8][0-9]{3}\|04449[0-5][0-9]{2}\|044496[0-7][0-9]{1}\|0444968[0-1])[0-9]{236}\|04449682(?:(?:[0-8][0-9]{7}\|9[0-1][0-9]{6}\|92[0-6][0-9]{5}\|927[0-5][0-9]{4}\|9276[0-3][0-9]{3}\|92764[0-6][0-9]{2}\|927647[0-4][0-9]{1})[0-9]{228}\|92764750(?:(?:[0-8][0-9]{7}\|9[0-3][0-9]{6}\|94[0-5][0-9]{5}\|946[0-5][0-9]{4}\|9466[0-3][0-9]{3}\|94664[0-8][0-9]{2}\|94664900)[0-9]{220}\|94664901(?:(?:[0-6][0-9]{7}\|7[0-8][0-9]{6}\|79[0-6][0-9]{5}\|797[0-6][0-9]{4}\|7977[0-4][0-9]{3}\|79775[0-7][0-9]{2}\|797758[0-6][0-9]{1}\|7977587[0-1])[0-9]{212}\|79775872(?:(?:0[0-6][0-9]{6}\|070[0-8][0-9]{4}\|0709[0-5][0-9]{3}\|07096[0-2][0-9]{2}\|070963[0-2][0-9]{1})[0-9]{204}\|07096330(?:(?:[0-1][0-9]{7}\|2[0-7][0-9]{6}\|28[0-5][0-9]{5}\|286[0-3][0-9]{4}\|28640[0-9]{3}\|28641[0-5][0-9]{2}\|286416[0-5][0-9]{1}\|2864166[0-8])[0-9]{196}\|28641669(?:(?:[0-1][0-9]{7}\|2[0-7][0-9]{6}\|28[0-7][0-9]{5}\|288[0-6][0-9]{4}\|2887[0-8][0-9]{3}\|288790[0-9]{2}\|2887910[0-8])[0-9]{188}\|28879109(?:(?:[0-3][0-9]{7}\|4[0-5][0-9]{6}\|46[0-4][0-9]{5}\|465[0-4][0-9]{4}\|4655[0-4][0-9]{3}\|46555[0-4][0-9]{2}\|465555[0-3][0-9]{1}\|4655554[0-6])[0-9]{180}\|46555547(?:(?:[0-7][0-9]{7}\|8[0-4][0-9]{6}\|850[0-9]{5}\|851[0-8][0-9]{4}\|8519[0-3][0-9]{3}\|851940[0-3][0-9]{1})[0-9]{172}\|85194040(?:(?:[0-1][0-9]{7}\|2[0-5][0-9]{6}\|26[0-2][0-9]{5}\|2630[0-5][0-9]{3}\|26306[0-4][0-9]{2}\|263065[0-6][0-9]{1}\|2630657[0-3])[0-9]{164}\|26306574(?:(?:[0-7][0-9]{7}\|8[0-7][0-9]{6}\|88[0-5][0-9]{5}\|886[0-6][0-9]{4}\|88670[0-9]{3}\|88671[0-4][0-9]{2}\|8867150[0-4])[0-9]{156}\|88671505(?:(?:[0-7][0-9]{7}\|8[0-1][0-9]{6}\|820[0-5][0-9]{4}\|8206[0-7][0-9]{3}\|820680[0-9]{2}\|820681[0-8][0-9]{1})[0-9]{148}\|82068190(?:(?:[0-7][0-9]{7}\|8[0-8][0-9]{6}\|890[0-1][0-9]{4}\|8902000[0-6])[0-9]{140}\|89020007(?:(?:0[0-7][0-9]{6}\|08[0-2][0-9]{5}\|083[0-7][0-9]{4}\|0838[0-2][0-9]{3}\|08383[0-5][0-9]{2}\|083836[0-6][0-9]{1}\|0838367[0-5])[0-9]{132}\|08383676(?:(?:[0-1][0-9]{7}\|2[0-6][0-9]{6}\|27[0-2][0-9]{5}\|273[0-7][0-9]{4}\|2738[0-4][0-9]{3}\|27385[0-3][0-9]{2}\|273854[0-7][0-9]{1}\|2738548[0-3])[0-9]{124}\|27385484(?:(?:[0-4][0-9]{7}\|5[0-7][0-9]{6}\|580[0-9]{5}\|581[0-6][0-9]{4}\|5817[0-6][0-9]{3}\|581770[0-9]{2}\|5817710[0-9]{1}\|5817711[0-4])[0-9]{116}\|58177115(?:(?:[0-2][0-9]{7}\|30[0-9]{6}\|31[0-6][0-9]{5}\|317[0-5][0-9]{4}\|3176[0-3][0-9]{3}\|31764[0-3][0-9]{2}\|317644[0-6][0-9]{1}\|3176447[0-4])[0-9]{108}\|31764475(?:(?:[0-6][0-9]{7}\|7[0-2][0-9]{6}\|730[0-1][0-9]{4}\|7302[0-6][0-9]{3}\|7302700[0-5])[0-9]{100}\|73027006(?:(?:[0-8][0-9]{7}\|9[0-7][0-9]{6}\|98[0-4][0-9]{5}\|985[0-4][0-9]{4}\|9855[0-4][0-9]{3}\|98555[0-6][0-9]{2}\|9855570[0-9]{1}\|9855571[0-2])[0-9]{92}\|98555713(?:(?:[0-5][0-9]{7}\|6[0-5][0-9]{6}\|66[0-8][0-9]{5}\|669[0-4][0-9]{4}\|6695[0-8][0-9]{3}\|66959[0-5][0-9]{2}\|669596[0-1][0-9]{1}\|6695962[0-1])[0-9]{84}\|66959622(?:(?:[0-7][0-9]{7}\|8[0-3][0-9]{6}\|84[0-1][0-9]{5}\|842[0-8][0-9]{4}\|84290[0-9]{3}\|84291[0-3][0-9]{2}\|842914[0-7][0-9]{1}\|84291480)[0-9]{76}\|84291481(?:(?:[0-8][0-9]{7}\|9[0-7][0-9]{6}\|98[0-5][0-9]{5}\|9860[0-7][0-9]{3}\|98608[0-2][0-9]{2}\|986083[0-3][0-9]{1}\|9860834[0-8])[0-9]{68}\|98608349(?:(?:[0-2][0-9]{7}\|3[0-5][0-9]{6}\|36[0-3][0-9]{5}\|364[0-6][0-9]{4}\|3647[0-4][0-9]{3}\|36475[0-1][0-9]{2}\|364752[0-8][0-9]{1}\|3647529[0-1])[0-9]{60}\|36475292(?:(?:[0-6][0-9]{7}\|70[0-9]{6}\|71[0-8][0-9]{5}\|7190[0-6][0-9]{3}\|71907[0-3][0-9]{2}\|7190740[0-9]{1}\|7190741[0-5])[0-9]{52}\|71907416(?:(?:[0-7][0-9]{7}\|8[0-3][0-9]{6}\|84[0-3][0-9]{5}\|844[0-3][0-9]{4}\|8444[0-2][0-9]{3}\|84443[0-5][0-9]{2}\|844436[0-4][0-9]{1}\|8444365[0-4])[0-9]{44}\|84443655(?:(?:0[0-9]{7}\|10[0-6][0-9]{5}\|1070[0-3][0-9]{3}\|10704[0-2][0-9]{2}\|107043[0-3][0-9]{1}\|1070434[0-1])[0-9]{36}\|10704342(?:(?:[0-6][0-9]{7}\|70[0-9]{6}\|710[0-9]{5}\|711[0-4][0-9]{4}\|7115[0-4][0-9]{3}\|71155[0-8][0-9]{2}\|711559[0-5][0-9]{1}\|7115596[0-8])[0-9]{28}\|71155969(?:(?:[0-8][0-9]{7}\|9[0-4][0-9]{6}\|950[0-7][0-9]{4}\|95080[0-8][0-9]{2}\|950809[0-2][0-9]{1})[0-9]{20}\|95080930(?:(?:[0-3][0-9]{7}\|4[0-1][0-9]{6}\|42[0-7][0-9]{5}\|428[0-7][0-9]{4}\|428800[0-9]{2}\|428801[0-6][0-9]{1}\|4288017[0-6])[0-9]{12}\|42880177(?:(?:[0-8][0-9]{7}\|90[0-3][0-9]{5}\|9040[0-9]{4}\|9041[0-6][0-9]{3}\|90417[0-3][0-9]{2}\|904174[0-3][0-9]{1}\|9041744[0-8])[0-9]{4}\|90417449(?:(?:[0-6][0-9]{3}\|7[0-6][0-9]{2}\|77[0-8][0-9]{1}\|7790)\|7791))))))))))))))))))))))))))))))))))))))))(?:[^0-9]\|$))
`message`	`string` Menschenlesbare Erklärung des Fehlers. Die Formulierung kann variieren; verwenden Sie den Code `error`, wenn Sie einen bestimmten Fehlerfall behandeln.
`reason`	`null \| string \| number \| boolean \| Array<beliebiger Wert> \| object` Eines der folgenden Schemas kann gelten: null `null` string `string` number `number` boolean `boolean` Array<beliebiger Wert> `Array<beliebiger Wert>` Schema eines Array-Elements `beliebiger Wert` object `object` Schema für zusätzliche Eigenschaften `beliebiger Wert`

HTTP 400

JSON-Response-Body. application/json text/plain; charset=utf-8

Schema des Response-Bodys

Vollständiges JSON Schema

JSON in einem neuen Tab öffnen

Benannte Fehler und das allgemeine Fehlerformat

error: "INVALID_PARAMS_FIELD"

Ungültiges Feld params übergeben, es enthält ungültiges JSON.

Die Antwort kann zusätzliche Felder enthalten.

Feld	Typ und Beschreibung
`error` erforderlich	`string` (immer: "INVALID_PARAMS_FIELD")
`http_code`	`number` (immer: 400)
`message`	`string` Menschenlesbare Erklärung des Fehlers. Die Formulierung kann variieren; verwenden Sie den Code `error`, wenn Sie einen bestimmten Fehlerfall behandeln.

Allgemeines Fehlerformat

Siehe die allgemeinen Felder der Fehlerantwort.

Weitere Informationen zur Antwort finden Sie in unserer Dokumentation zur Assembly-Status-Antwort.

Eine Assembly mit einer vorgegebenen ID erstellen

Anfragebeispiel

Authentifizierung

Pfadparameter

Optionale Query-Parameter für die Antwort

Multipart-Formularfelder

Unterstützte Schlüssel im Feld params

Anfrageparameter nach Authentifizierungsmethode

Antwort

2xx-Erfolg

Fehlerantwort

HTTP 400

Unterstützte Schlüssel im Feld `params`