# Recuperar la lista de Templates

GET`https://api2.transloadit.com/templates?signature={SIGNATURE}&params={PARAMS}`

###### Advertencia

Este endpoint requiere que tu [Auth Key](/es/docs/api/authentication.md) tenga el alcance `templates:read`.

## Componentes de consulta de GET

* Es obligatorio incluir `signature`. Para obtener más información, consulta [Signature Authentication](/es/docs/api/authentication.md).
* 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:\
![](/_next/static/media/copy.04p1cju9qekk_.svg?dpl=dpl_GBjmaCTpH3rF6sBBsH4gkTL4K8CU)

```jsonc
{  
  "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:\
![](/_next/static/media/copy.04p1cju9qekk_.svg?dpl=dpl_GBjmaCTpH3rF6sBBsH4gkTL4K8CU)

```jsonc
{  
  // …  
  "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](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global%5FObjects/RegExp).\
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](/docs/robots/file-filter.md).\
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ántos Templates se recibirán por solicitud a la API, lo cual resulta útil para la paginación.

* ### `sort`

`id | name | created | modified`(valor predeterminado: `"created"`)\
El campo por el que se ordenarán los resultados.

* ### `order`

`asc | desc`(valor predeterminado: `"desc"`)\
La dirección de ordenación. Puede ser `"desc"` para orden descendente (predeterminado) o `"asc"` para orden ascendente.

* ### `fromdate` — **obligatorio**

`string`\
Especifica la fecha y hora UTC mínima de creación del Template. Solo se recuperarán los Templates creados después de 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 del Template. Solo se recuperarán los Templates creados antes de ese momento. Usa el formato `Y-m-d H:i:s`.

* ### `keywords`

`Array<string>`(valor predeterminado: `[]`)\
Especifica las palabras clave que se compararán con los nombres de los Templates. Cuando se incluyen Builtin Templates, también se buscan coincidencias en sus slugs de Builtin Template.

* ### `include_builtin`

`none | latest | all | exclusively-latest | exclusively-all`\
Incluye Builtin Templates en los resultados. Usa `latest` (recomendado) o `all`. Añade el prefijo `exclusively-` para devolver únicamente Builtin Templates.

## Respuesta

Devuelve el código de error `TEMPLATE_LIST_ERROR` o una lista JSON de Templates encontrados. Usa `include_builtin` para incluir en los resultados los Builtin Templates mantenidos por Transloadit.