Transloadit

Liste der Assemblies abrufen

GEThttps://api2.transloadit.com/assemblies?signature={SIGNATURE}&params={PARAMS}

Ruft eine Liste der Assemblies für Ihr Konto ab. Sie sind nach Erstellungsdatum absteigend sortiert.

GET-Abfragekomponenten

  • Die Übergabe von signature ist erforderlich. Weitere Informationen finden Sie unter Signature Authentication.
  • Die Übergabe von params ist erforderlich. Das Feld sollte ein JSON-codiertes Objekt mit den in der folgenden Tabelle aufgeführten Schlüsseln enthalten.

Unterstützte Schlüssel im Feld params

  • auth — erforderlich

    object

    Enthält mindestens den Auth Key von Transloadit 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": "2009-08-28T01:02:03.000Z"
}

    Wir empfehlen dringend, die Eigenschaft nonce einzuschließen – einen zufällig generierten, pro Anfrage eindeutigen Wert. Dieser verhindert eine doppelte Verarbeitung bei Retries, kann die Fehlerdiagnose erleichtern und vermeidet Angriffsvektoren wie die Wiederverwendung von Signaturschlüsseln:

    {
  // …
  "nonce": "04ac6cb6-df43-41fb-a7fd-e5dd711a64e1"
}

    Die Eigenschaft referer ist ein regulärer Ausdruck, der mit dem HTTP-Referrer dieses Uploads abgeglichen wird, beispielsweise "example\.org". Geben Sie diesen Schlüssel an, um sicherzustellen, dass Uploads nur von Ihrer Domain stammen.

    Uploads ohne Referrer werden immer akzeptiert, da Referrer in einigen Browsern deaktiviert sind. Daher ist dies nur für wenige Anwendungsfälle nützlich. Einzelheiten zu regulären Ausdrücken finden Sie in der RegExp-Dokumentation von Mozilla.

    Mit der Eigenschaft max_size können Sie eine maximale Größe in Bytes für einen Upload festlegen, beispielsweise 1048576 (1 MB). Geben Sie diese an, um zu verhindern, dass Benutzer übermäßig große Dateien hochladen. Die Dateigröße wird geprüft, sobald der Upload beginnt. Überschreitet sie die maximale Größe, wird der gesamte Upload-Vorgang abgebrochen und die Assembly schlägt fehl – selbst wenn sie Dateien enthält, die den Grenzwert max_size nicht überschreiten. Wenn Sie nur Dateien ignorieren möchten, die eine bestimmte Größe überschreiten, und alle anderen verarbeiten möchten, verwenden Sie bitte 🤖/file/filter.

    Mit der Eigenschaft max_number_of_files können Sie die maximale Anzahl von Dateien für einen Upload festlegen, beispielsweise 100. Geben Sie diese an, um zu verhindern, dass Benutzer übermäßig viele Dateien hochladen – sowohl über Datei-Uploads als auch über Import-Robots.

    Diese Eigenschaften können entweder in der Assembly-Anfrage oder im Template festgelegt werden.

  • page

    number(Standard: 1)

    Gibt die aktuelle Seite innerhalb der derzeitigen Paginierung an.

  • pagesize

    number(Standard: 50)

    Gibt an, wie viele Assemblies pro API-Anfrage empfangen werden. Dies ist für die Paginierung nützlich.

  • type — erforderlich

    all | uploading | executing | canceled | completed | failed | request_aborted

    Gibt die Typen der abzurufenden Assemblies an.

  • fromdate — erforderlich

    string

    Gibt das früheste UTC-Erstellungsdatum mit Uhrzeit für Assemblies an. Nur Assemblies nach diesem Zeitpunkt werden abgerufen. Verwenden Sie das Format Y-m-d H:i:s.

  • todate

    string(Standard: "NOW()")

    Gibt das späteste UTC-Erstellungsdatum mit Uhrzeit für Assemblies an. Nur Assemblies vor diesem Zeitpunkt werden abgerufen. Verwenden Sie das Format Y-m-d H:i:s.

  • keywords — erforderlich

    Array<string>

    Gibt Schlüsselwörter an, nach denen im Assembly Status gesucht wird. Zu den geprüften Feldern der Assembly gehören id, redirect_url, fields und notify_url sowie Fehlermeldungen und verwendete Dateien.

Antwort

Hier sehen Sie ein Beispiel für einen Antworttext:

{
  "items": [
    {
      "id": "195c60855fda4fb9a3b2f848374ca4e1",
      "parent_id": null,
      "account_id": "7c91e50845204dea9ed4791f7d8440f1",
      "template_id": "40b0efc6b37f432dbe9485017b52a7b7",
      "instance": "tam.transloadit.com",
      "notify_url": null,
      "redirect_url": null,
      "files": "[\"Saturn as seen from the Cas....jpg\"]",
      "region": "eu-west-1",
      "warning_count": 0,
      "execution_duration": 2.337,
      "execution_start": "2023-02-11T16:04:24.000Z",
      "ok": "ASSEMBLY_COMPLETED",
      "error": null,
      "created": "2023-02-11T16:04:22.000Z",
      "created_ts": 1676131462,
      "template_name": "my-template-1676131432311"
    },
    {
      "id": "72fc13f46db84fa1969d913ca8763de1",
      "parent_id": null,
      "account_id": "7c91e50845204dea9ed4791f7d8440f1",
      "template_id": "40b0efc6b37f432dbe9485017b52a7b7",
      "instance": "tam.transloadit.com",
      "notify_url": null,
      "redirect_url": null,
      "files": "[\"green grass fiels.jpg\",\"Morning Dew.jpg\",\"green leaf plant.jpg\"]",
      "region": "eu-west-1",
      "warning_count": 0,
      "execution_duration": 6.275,
      "execution_start": "2023-02-11T16:04:06.000Z",
      "ok": "ASSEMBLY_COMPLETED",
      "error": null,
      "created": "2023-02-11T16:04:04.000Z",
      "created_ts": 1676131444,
      "template_name": "my-template-1676131432311"
    }
  ],
  // …
  "count": 50
}

Wir geben entweder den Fehlercode ASSEMBLY_LIST_ERROR oder eine JSON-Liste der gefundenen Assemblies zurück.