<span aria-hidden="true" id="retrieve-list-of-template-credentials"></span><span aria-hidden="true" id="recuperar-la-lista-de-credenciales-de-template"></span>



# Recuperar la lista de credenciales de Template

Enumera las credenciales de Template del Workspace autenticado.

`GET` `https://api2.transloadit.com/template_credentials`

Obtiene una lista de credenciales de Template de tu cuenta.

<span aria-hidden="true" id="request-example"></span><span aria-hidden="true" id="ejemplo-de-solicitud"></span>



## Ejemplo de solicitud

Los Workspaces cancelados no pueden crear nuevos tokens Bearer. Este endpoint sigue estando disponible con una Auth Key activa existente: usa la [guía de lectura firmada](/es/docs/api/authentication.md#read-access-after-cancellation) en lugar de la configuración del token que aparece a continuación. La Auth Key debe conceder los ámbitos requeridos por este endpoint.

Ejecuta esta solicitud en una shell del lado del servidor con `curl` y un [token Bearer](/es/docs/api/token-post.md) adecuado en `TRANSLOADIT_TOKEN`. Si necesitas un token, despliega la configuración que aparece a continuación.

**¿Necesitas un token Bearer?**

En una shell de confianza del lado del servidor con `curl` y `jq`, asigna a `TRANSLOADIT_KEY` y `TRANSLOADIT_SECRET` los valores de tu Auth Key y tu Auth Secret. Mantén en secreto ambas credenciales y el token resultante; nunca ejecutes esta configuración en código del navegador.

Primero, crea un token con los ámbitos requeridos por este endpoint. Tu Auth Key ya debe conceder esos ámbitos.

```bash
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=template_credentials:read')"; 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
```

Mantén abierta esta shell y ejecuta la solicitud que aparece a continuación. Reutiliza el token mientras siga siendo válido.

```bash
curl --fail-with-body -sS --request GET --get \
  --url "https://api2.transloadit.com/template_credentials" \
  --header "Authorization: Bearer ${TRANSLOADIT_TOKEN:?Set TRANSLOADIT_TOKEN}" \
  --data-urlencode 'params={}'
```

<span aria-hidden="true" id="authentication"></span>



## Autenticación

Este endpoint acepta `params` firmados o un token Bearer. Consulta [Autenticación](/es/docs/api/authentication.md) para ver las instrucciones de configuración.

Ámbito requerido para el Auth Key o el token de portador: `template_credentials:read`.

Las solicitudes firmadas requieren tanto una `signature` como una marca de tiempo futura en `params.auth.expires`. Los tokens Bearer no requieren ninguno de estos dos elementos.

<span aria-hidden="true" id="get-query-components"></span><span aria-hidden="true" id="componentes-de-consulta-de-get"></span>



## Parámetros de consulta

* `params` (cadena JSON). Un objeto codificado en JSON cuyas claves compatibles se enumeran a continuación.
* `signature` (cadena). Obligatorio para las solicitudes firmadas. Omite este campo cuando uses un token Bearer.

<span aria-hidden="true" id="params-fields"></span><span aria-hidden="true" id="supported-keys"></span><span aria-hidden="true" id="supported-keys-inside-the-params-field"></span><span aria-hidden="true" id="claves-admitidas-en-el-campo-params"></span>



## Claves admitidas en el campo firmado `params`

Los campos de autenticación de esta lista se aplican a las solicitudes firmadas. Con un token Bearer puedes omitir `params.auth` y el campo separado `signature`. Compara a continuación los parámetros de solicitud de cada método de autenticación.

[JSON Schema completo](/api-reference/schemas/template-credentials-get/params-fields.json)

`params`: Solo se aceptan los campos enumerados para este objeto.

<span aria-hidden="true" id="params-fields-auth"></span><span aria-hidden="true" id="auth"></span>



### `params.auth` (obligatorio para las solicitudes firmadas; opcional con un token Bearer)

[`object`](#params-fields-auth-expires)

Contiene la clave de API de Transloadit y los metadatos de Signature Authentication para una solicitud de credenciales de Template.

`params.auth`: Solo se aceptan los campos enumerados para este objeto.

<span aria-hidden="true" id="params-fields-auth-expires"></span>



#### `params.auth.expires` (obligatorio)

`string`

Marca de tiempo de vencimiento ISO 8601 en el futuro. Es obligatoria cuando una solicitud está firmada o requiere autenticación mediante firma; las solicitudes autenticadas con Bearer pueden omitirla.

<span aria-hidden="true" id="params-fields-auth-key"></span>



#### `params.auth.key` (obligatorio)

`string`

Clave de API de Transloadit utilizada para autenticar solicitudes

<span aria-hidden="true" id="params-fields-nonce"></span><span aria-hidden="true" id="params-fields-auth-nonce"></span><span aria-hidden="true" id="nonce"></span>



### `params.nonce`

`string | integer`

Valor aleatorio y único incluido en los parámetros de las solicitudes firmadas para que cada firma sea única y evitar su reutilización accidental.

<span aria-hidden="true" id="authentication-specific-params"></span>



## Parámetros de solicitud según el método de autenticación

<span aria-hidden="true" id="signed-params"></span>



### Con parámetros firmados

Incluye tu Auth Key como `params.auth.key`. Al firmar la solicitud, incluye una marca de tiempo futura en `params.auth.expires` y envía la Signature en el campo separado `signature`. Las definiciones de los campos que aparecen a continuación usan rutas dentro de `params`.

[JSON Schema completo](/api-reference/schemas/template-credentials-get/signed-params.json)

`params`: Solo se aceptan los campos enumerados para este objeto.

<span aria-hidden="true" id="signed-params-auth"></span><span aria-hidden="true" id="signed-params-auth-expires"></span><span aria-hidden="true" id="signed-params-auth-key"></span><span aria-hidden="true" id="signed-params-nonce"></span><span aria-hidden="true" id="signed-params-auth-nonce"></span>



Utiliza las definiciones de campos indicadas arriba: [`params.auth`](#params-fields-auth), [`params.nonce`](#params-fields-nonce)

<span aria-hidden="true" id="bearer-params"></span>



### Con un token Bearer

Envía el token Bearer en el encabezado `Authorization`. Puedes omitir `params.auth` y el campo independiente `signature`. Los demás parámetros obligatorios siguen siendo necesarios. Las definiciones de los campos que aparecen a continuación usan rutas dentro de `params`.

[JSON Schema completo](/api-reference/schemas/template-credentials-get/bearer-params.json)

`params`: Solo se aceptan los campos enumerados para este objeto.

<span aria-hidden="true" id="bearer-params-nonce"></span><span aria-hidden="true" id="bearer-params-auth-nonce"></span>



Utiliza las definiciones de campos indicadas arriba: [`params.nonce`](#params-fields-nonce)

<span aria-hidden="true" id="bearer-params-auth"></span>



#### `params.auth`

[`object`](#bearer-params-auth-expires)

Contiene la clave de API de Transloadit y los metadatos de Signature Authentication para una solicitud de credenciales de Template.

`params.auth`: Solo se aceptan los campos enumerados para este objeto.

<span aria-hidden="true" id="bearer-params-auth-expires"></span>



##### `params.auth.expires`

`string`

Marca de tiempo de vencimiento ISO 8601 en el futuro. Es obligatoria cuando una solicitud está firmada o requiere autenticación mediante firma; las solicitudes autenticadas con Bearer pueden omitirla.

<span aria-hidden="true" id="bearer-params-auth-key"></span>



##### `params.auth.key`

`string`

Clave de API de Transloadit utilizada para autenticar solicitudes

<span aria-hidden="true" id="response"></span><span aria-hidden="true" id="respuesta"></span>



## Respuesta

<span aria-hidden="true" id="response-1"></span>



### éxito 2xx

Cuerpo de respuesta JSON. `application/json` `text/plain; charset=utf-8`

<span aria-hidden="true" id="response-1-body"></span>



#### Esquema del cuerpo de la respuesta

[JSON Schema completo](/api-reference/schemas/template-credentials-get/response-1-body.json)

La respuesta puede contener campos adicionales.

<span aria-hidden="true" id="response-1-body-credentials"></span>



##### `credentials` (obligatorio)

`Array<object>`

**Esquema de los elementos del array**

[`object`](#response-1-body-credentials-items-1-account_id)

`credentials[]`: La respuesta contiene únicamente los campos listados para este objeto.

<span aria-hidden="true" id="response-1-body-credentials-items-1-account_id"></span>



###### `credentials[].account_id` (obligatorio)

`string`

<span aria-hidden="true" id="response-1-body-credentials-items-1-content"></span>



###### `credentials[].content` (obligatorio)

`object | Array<cualquier valor> | string | number | boolean | null`

[Los detalles adicionales del esquema están disponibles en el JSON Schema completo.](/api-reference/schemas/template-credentials-get/response-1-body.json)

<span aria-hidden="true" id="response-1-body-credentials-items-1-created"></span>



###### `credentials[].created` (obligatorio)

`number | string | null`

**Puede aplicarse cualquiera de los esquemas siguientes:**

* `number | string`
* `null`

<span aria-hidden="true" id="response-1-body-credentials-items-1-deleted"></span>



###### `credentials[].deleted` (obligatorio)

`number | string | null`

**Puede aplicarse cualquiera de los esquemas siguientes:**

* `number | string`
* `null`

<span aria-hidden="true" id="response-1-body-credentials-items-1-id"></span>



###### `credentials[].id` (obligatorio)

`string`

<span aria-hidden="true" id="response-1-body-credentials-items-1-modified"></span>



###### `credentials[].modified` (obligatorio)

`number | string | null`

**Puede aplicarse cualquiera de los esquemas siguientes:**

* `number | string`
* `null`

<span aria-hidden="true" id="response-1-body-credentials-items-1-name"></span>



###### `credentials[].name` (obligatorio)

`string`

<span aria-hidden="true" id="response-1-body-credentials-items-1-stringified"></span>



###### `credentials[].stringified` (obligatorio)

`string`

<span aria-hidden="true" id="response-1-body-credentials-items-1-type"></span>



###### `credentials[].type` (obligatorio)

`string`

<span aria-hidden="true" id="response-1-body-message"></span>



##### `message` (obligatorio)

`string` (longitud mínima: 1)

<span aria-hidden="true" id="response-1-body-ok"></span>



##### `ok` (obligatorio)

`string` (siempre: "TEMPLATE\_CREDENTIALS\_FOUND")

<span aria-hidden="true" id="response-2"></span>



### Respuesta de error

Cuerpo de respuesta JSON. `application/json` `text/plain; charset=utf-8`

<span aria-hidden="true" id="response-2-body"></span>



#### Esquema del cuerpo de la respuesta

[JSON Schema completo](/api-reference/schemas/template-credentials-get/response-2-body.json)

Se requiere al menos una de estas propiedades: error, message, reason

La respuesta puede contener campos adicionales.

<span aria-hidden="true" id="response-2-body-allOf-1-assembly_id"></span>



##### `assembly_id`

`string`

<span aria-hidden="true" id="response-2-body-allOf-1-error"></span>



##### `error`

`string` (longitud mínima: 1)

<span aria-hidden="true" id="response-2-body-allOf-1-http_code"></span>



##### `http_code`

`number | string`

* `number`
* `string`

  [Patrón de validación (expresión regular)](/api-reference/schemas/template-credentials-get/response-2-body.json)

<span aria-hidden="true" id="response-2-body-allOf-1-message"></span>



##### `message`

`string`

Explicación del error legible por humanos. Su redacción puede variar; usa el código `error` cuando manejes un fallo específico.

<span aria-hidden="true" id="response-2-body-allOf-1-reason"></span>



##### `reason`

`null | string | number | boolean | Array<cualquier valor> | object`

**Puede aplicarse cualquiera de los esquemas siguientes:**

* `null`
* `string`
* `number`
* `boolean`
* `Array<cualquier valor>`

  * **Esquema de los elementos del array**

    `cualquier valor`
* `object`

  * **Esquema de propiedades adicionales**

    `cualquier valor`

<span aria-hidden="true" id="response-3"></span>



### HTTP 400

Cuerpo de respuesta JSON. `application/json` `text/plain; charset=utf-8`

<span aria-hidden="true" id="response-3-body"></span>



#### Esquema del cuerpo de la respuesta

[JSON Schema completo](/api-reference/schemas/template-credentials-get/response-3-body.json)

**Errores con nombre y el formato general de error**

* **error: "TEMPLATE\_CREDENTIALS\_NOT\_FOUND"**

  No se pudieron encontrar tus credenciales de Template.

  La respuesta puede contener campos adicionales.

  * <span aria-hidden="true" id="response-3-body-anyOf-1-error"></span>



    **`error` (obligatorio)**

    `string` (siempre: "TEMPLATE\_CREDENTIALS\_NOT\_FOUND")
  * <span aria-hidden="true" id="response-3-body-anyOf-1-http_code"></span>



    **`http_code`**

    `number` (siempre: 400)
  * <span aria-hidden="true" id="response-3-body-anyOf-1-message"></span>



    **`message`**

    `string`

    Explicación del error legible por humanos. Su redacción puede variar; usa el código `error` cuando manejes un fallo específico.
* **Formato general de error**

  <span aria-hidden="true" id="response-3-body-anyOf-2-allOf-1-assembly_id"></span><span aria-hidden="true" id="response-3-body-anyOf-2-allOf-1-error"></span><span aria-hidden="true" id="response-3-body-anyOf-2-allOf-1-http_code"></span><span aria-hidden="true" id="response-3-body-anyOf-2-allOf-1-message"></span><span aria-hidden="true" id="response-3-body-anyOf-2-allOf-1-reason"></span>



  [Consulta los campos generales de la respuesta de error.](#response-2-body)
* **error: "SIGNATURE\_REUSE\_DETECTED"**

  La solicitud fue denegada por motivos de seguridad. Si crees que esto es un error, ponte en contacto con soporte.

  La respuesta puede contener campos adicionales.

  * <span aria-hidden="true" id="response-3-body-anyOf-3-error"></span>



    **`error` (obligatorio)**

    `string` (siempre: "SIGNATURE\_REUSE\_DETECTED")
  * <span aria-hidden="true" id="response-3-body-anyOf-3-http_code"></span>



    **`http_code`**

    `number` (siempre: 400)
  * <span aria-hidden="true" id="response-3-body-anyOf-3-message"></span>



    **`message`**

    `string`

    Explicación del error legible por humanos. Su redacción puede variar; usa el código `error` cuando manejes un fallo específico.
