Recuperar la lista de Assemblies

Recupera una lista de Assemblies de tu cuenta. Se ordenan por fecha de creación en orden descendente.

Componentes de consulta de GET

• Es obligatorio incluir signature. Para obtener más información, consulta Signature Authentication.
• Es obligatorio incluir params. Debe contener un objeto codificado en JSON con las claves que se muestran en la siguiente tabla.

Claves admitidas en el campo params

• auth — obligatorio

  object

  Contiene, como mínimo, tu Auth Key de Transloadit en la propiedad key.

  Si habilitas Signature Authentication, también debes establecer una fecha de vencimiento para la solicitud en la propiedad expires:

  {
    "key": "23c96d084c744219a2ce156772ec3211",
    "expires": "2009-08-28T01:02:03.000Z"
  }
  

  Recomendamos encarecidamente incluir la propiedad nonce: un valor único generado aleatoriamente para cada solicitud que evita el procesamiento duplicado durante los reintentos, puede ayudar con la depuración y evita vectores de ataque como la reutilización de claves de firma:

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

  La propiedad referer es una expresión regular que se compara con el referente HTTP de esta subida, como "example\.org". Especifica esta clave para asegurarte de que las subidas solo procedan de tu dominio.

  Las subidas sin referente siempre pasarán la comprobación, ya que algunos navegadores lo desactivan, por lo que esto solo resulta útil en unos pocos casos de uso. Para obtener detalles sobre las expresiones regulares, consulta la documentación de RegExp de Mozilla⁠.

  La propiedad max_size puede utilizarse para establecer el tamaño máximo en bytes de una subida, como 1048576 (1 MB). Especifícalo para impedir que los usuarios suban archivos excesivamente grandes. El tamaño de los archivos se comprueba en cuanto comienza la subida. Si supera el tamaño máximo, se cancela todo el proceso de subida y la Assembly genera un error, aunque contenga archivos que no superen el límite de max_size. Si solo quieres ignorar los archivos que superen cierto tamaño y procesar todos los demás, usa 🤖/file/filter.

  La propiedad max_number_of_files puede utilizarse para establecer la cantidad máxima de archivos que puede contener una subida, como 100. Especifícalo para impedir que los usuarios suban una cantidad excesiva de archivos, tanto mediante subidas de archivos como mediante Robots de importación.

  Estas propiedades pueden establecerse como parte de la solicitud de la Assembly o como parte del Template.

• page

  number(valor predeterminado: 1)

  Especifica la página actual dentro de la paginación en curso

• pagesize

  number(valor predeterminado: 50)

  Especifica cuántas Assemblies se recibirán por solicitud a la API, lo que resulta útil para la paginación.

• type — obligatorio

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

  Especifica los tipos de Assemblies que se recuperarán.

• fromdate — obligatorio

  string

  Especifica la fecha y hora UTC mínima de creación de la Assembly. Solo se recuperarán las Assemblies posteriores a ese momento. Usa el formato Y-m-d H:i:s.

• todate

  string(valor predeterminado: "NOW()")

  Especifica la fecha y hora UTC máxima de creación de la Assembly. Solo se recuperarán las Assemblies anteriores a ese momento. Usa el formato Y-m-d H:i:s.

• keywords — obligatorio

  Array<string>

  Especifica las palabras clave que deben coincidir en el Assembly Status. Los campos de la Assembly que se comprueban incluyen id, redirect_url, fields y notify_url, además de los mensajes de error y los archivos utilizados.

Respuesta

Este es un ejemplo del cuerpo de la respuesta:

{
  "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
}

Devolvemos el código de error ASSEMBLY_LIST_ERROR o una lista JSON de las Assemblies encontradas.