Crear un nuevo Template

Crea un Template reutilizable a partir de Assembly Instructions.

POSThttps://api2.transloadit.com/templates

Los Templates nuevos, incluidas las copias, siempre comienzan con la programación con Cron desactivada. Un Workspace que cumpla los requisitos puede guardar su región de cron, su programación en UTC y el ID de la Auth Key al crear un Template, y después habilitar explícitamente la programación en una actualización independiente tras revisar estos ajustes.

Ejemplo de solicitud

Ejecuta esta solicitud en una shell del lado del servidor con curl y un token Bearer adecuado en TRANSLOADIT_TOKEN. Si necesitas un token, despliega la sección de 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 que requiere este endpoint. Tu Auth Key ya debe conceder esos ámbitos.

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=templates: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

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

curl --fail-with-body -sS --request POST \
  --url "https://api2.transloadit.com/templates" \
  --header "Authorization: Bearer ${TRANSLOADIT_TOKEN:?Set TRANSLOADIT_TOKEN}" \
  --data-urlencode 'params={"name":"resize-images","template":{"steps":{"resize":{"robot":"/image/resize","use":":original","width":320}}}}'

Autenticación

Este endpoint acepta params firmados o un token Bearer. Consulta Autenticación para ver las instrucciones de configuración.

Ámbito requerido para el Auth Key o el token de portador: templates:write.

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.

Campos del formulario

Tipo de contenido: application/x-www-form-urlencoded

params (cadena JSON), obligatorio. 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.

Claves admitidas dentro del campo `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

Abrir JSON en una pestaña nueva

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

Campo Tipo y descripción

params.assembly_status_expiry

"1day" | "30days" | "7days" | "90days" | "NoSave"

Controla cuánto tiempo se conserva el Assembly Status de las Assemblies creadas a partir de este Template.

params.auth

obligatorio para las solicitudes firmadas; opcional con un token Bearer

object

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

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

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.

params.auth.key

obligatorio

string

Clave de API de Transloadit utilizada para autenticar solicitudes

params.cron_auth_key_id

string | null

ID de una Auth Key activa y no caducada que pertenezca a este Workspace y tenga permiso para crear Assemblies. Obligatorio al habilitar la vista previa del Template de Cron. La clave debe permitir firmar y no puede ser una clave interna.

Patrón de validación (expresión regular)

^[a-f0-9]{32}$

params.cron_enabled

boolean (valor predeterminado: false)

Los nuevos Templates y las copias siempre se crean con la programación deshabilitada, incluso cuando este campo es true. Habilita la programación mediante una actualización independiente del Template después de revisar su región, su programación, sus Instructions y su Auth Key.

params.cron_max_concurrent_runs

integer (mínimo: 1, máximo: 10)

Número máximo de ejecuciones programadas simultáneas de este Template. El valor predeterminado es 1 al crearlo; si se omite al actualizarlo, se conserva el límite guardado. Las activaciones que se producen con el límite alcanzado se omiten, no se ponen en cola. Los inicios pendientes y las ejecuciones sin resolver cuentan hasta que se completan o hasta que vence el tiempo de espera por pérdida del punto de control. Las ejecuciones perdidas liberan su cupo de forma permanente, por lo que una Assembly tardía puede superar temporalmente este límite. No elimina duplicados de los archivos importados ni limita las Assemblies manuales. Los límites habituales del Workspace siguen aplicándose.

params.cron_region

"ap-southeast-1" | "eu-west-1" | "us-east-1" | null

API regional utilizada para las Assemblies programadas. Obligatoria al habilitar la vista previa de Cron Template.

params.cron_schedule_with_seconds

string | null (longitud mínima: 1, longitud máxima: 255)

Expresión cron numérica de seis campos, evaluada en UTC: segundo, minuto, hora, día del mes, mes y día de la semana. Admite comodines, valores separados por comas, rangos e incrementos. Las activaciones programadas deben estar separadas por al menos 10 segundos. La programación de Templates mediante cron es una versión preliminar con acceso controlado.

params.name

obligatorio

string (longitud mínima: 3, longitud máxima: 200)

Nombre de este Template. Usa entre 3 y 200 letras latinas minúsculas, números o guiones. El nombre tmp y los nombres reservados por el servicio no están disponibles.

Patrón de validación (expresión regular)

^(?:[a-su-z0-9-][a-z0-9-]{2,199}|t[a-ln-z0-9-][a-z0-9-]{1,198}|tm[a-oq-z0-9-][a-z0-9-]{0,197}|tmp[a-z0-9-]{1,197})$

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.

params.require_signature_auth

0 | 1 (valor predeterminado: 0)

Use 1 para exigir una Signature válida al crear Assemblies a partir de este Template con una Auth Key. Los tokens de portador válidos están exentos de este requisito de Signature; sus ámbitos y su audiencia siguen siendo aplicables. Esta configuración no añade autenticación a las URL de Assembly Status, cancelación o capacidad de carga. Consulte Signature Authentication.

params.template

obligatorio

object | string

Las Assembly Instructions almacenadas en este Template. Se recomienda usar el objeto JSON estructurado; por compatibilidad, se sigue aceptando una cadena codificada en JSON.

Puede aplicarse cualquiera de los esquemas siguientes:

object

object

Assembly Instructions estructuradas almacenadas en este Template.

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

Campo	Tipo y descripción
`params.template.allow_steps_override`	`boolean` Establece este valor en false en un Template almacenado para impedir que se sobrescriban sus Steps en tiempo de ejecución. Después puedes usar el Template con `template_id`, o proporcionar `steps` directamente sin él, pero no ambas opciones a la vez. Un valor proporcionado únicamente al crear una Assembly no controla esta política.
`params.template.auth`	`object` Autenticación y restricciones de subida opcionales para una Assembly. La clave de API puede omitirse en solicitudes autenticadas con Bearer o cuando solo se almacenan restricciones de subida en un Template. Los detalles adicionales del esquema están disponibles en el JSON Schema completo.
`params.template.emit_execution_progress`	`boolean` Establece este valor en true para publicar eventos en tiempo real sobre el progreso de ejecución de la Assembly. Esta opción se ignora en las URL Transform Assemblies.
`params.template.exiftool_stack`	`string` Se ignora cuando se almacena en un Template. Para seleccionar la pila de ExifTool para la extracción de metadatos, establece en su lugar `exiftool_stack` en los parámetros de nivel superior de la solicitud de la Assembly.
`params.template.ffmpeg_stack`	`string` Se ignora cuando se almacena en un Template. Para seleccionar la pila de FFmpeg para la extracción de metadatos, establece en su lugar `ffmpeg_stack` en los parámetros de nivel superior de la solicitud de la Assembly.
`params.template.fields`	`object` Un objeto de valores identificados por claves de cadena (nombre -> valor) que pueden utilizarse como Assembly Variables, al igual que los campos adicionales de un formulario. Puedes usar como valor cualquier elemento que pueda serializarse como JSON Los detalles adicionales del esquema están disponibles en el JSON Schema completo.
`params.template.imagemagick_stack`	`string` Se ignora cuando se almacena en un Template. Para seleccionar la pila de ImageMagick para la extracción de metadatos, configura en su lugar `imagemagick_stack` en los parámetros de nivel superior de la solicitud de la Assembly.
`params.template.mediainfo_stack`	`string` Se ignora cuando se almacena en un Template. Para seleccionar la pila de MediaInfo para la extracción de metadatos, establece, en su lugar, `mediainfo_stack` en los parámetros de nivel superior de la solicitud de la Assembly.
`params.template.mplayer_stack`	`string` Se ignora cuando se almacena en un Template. Para seleccionar la pila de MPlayer para la extracción de metadatos, establece en su lugar `mplayer_stack` en los parámetros de nivel superior de la solicitud de la Assembly.
`params.template.notification_payload`	`Array<"without_params" \| "without_result_meta_data" \| "without_results" \| "without_upload_meta_data" \| "without_uploads">` Controla el tamaño de la carga útil enviada en las Notifications de Assembly. Los reenvíos de Notifications reutilizan los filtros proporcionados en la solicitud original de Assembly; los filtros definidos solo en un Template no se conservan al reenviar. Un arreglo vacío (valor predeterminado) envía el Assembly Status completo. Añade `"without_params"` para que se omitan los campos sin procesar `params`, `template` y `merged_params` de Assembly Instructions. Añade `"without_result_meta_data"` para que se omita `meta` de cada archivo en `results`. Añade `"without_results"` para que se omita el objeto de nivel superior `results`. Añade `"without_upload_meta_data"` para que se omita `meta` de cada archivo en `uploads`. Añade `"without_uploads"` para que se omita el arreglo de nivel superior `uploads`. El filtrado se aplica antes de la serialización, por lo que usar estas opciones reduce el uso de memoria y ayuda a evitar fallos por cargas útiles demasiado grandes o por falta de memoria en Assemblies grandes.
`params.template.notify_url`	`null \| string` Transloadit puede enviar una devolución de llamada a tu servidor cuando se complete la Assembly. Enviaremos el Assembly Status como una cadena JSON en el campo `transloadit` de una solicitud POST con `application/x-www-form-urlencoded` a la URL proporcionada aquí. Usa `notification_payload` para reducir el tamaño de la carga útil (p. ej., `without_uploads`, `without_results`, `without_params`). Los reenvíos de Notifications reutilizan solo los filtros proporcionados en la solicitud original de Assembly, no los definidos únicamente en un Template.
`params.template.quiet`	`boolean` Establece este valor en true para minimizar la respuesta inicial de creación de la Assembly. Una respuesta correcta solo incluye ok y assembly_id; una respuesta de error conserva error, http_code, message, reason y assembly_id cuando estén disponibles. Esto minimiza la respuesta, pero no controla el acceso: cualquier persona con el Assembly ID devuelto puede seguir consultando el Assembly Status completo, incluidos los campos y los resultados, sin autenticación adicional. Trata los Assembly IDs y las URLs de estado como capacidades de acceso secretas. El Assembly Status completo sigue enviándose a notify_url cuando está configurada.
`params.template.redirect_url`	`string` URL a la que se redirige una subida desde el navegador una vez finalizada. El ID de la Assembly y la URL de estado se añaden como parámetros de consulta, conservando los parámetros de consulta y el fragmento existentes.
`params.template.response_headers`	`object` Cabeceras de respuesta personalizadas emitidas por una Assembly. Configura las cabeceras CORS dentro de `response_headers.cors`, por ejemplo `response_headers: { "cors": { "Access-Control-Allow-Origin": "https://example.com", "Access-Control-Allow-Methods": "GET, POST, OPTIONS" } }`. Las demás claves de nivel superior de `response_headers` se emiten como cabeceras personalizadas. Los detalles adicionales del esquema están disponibles en el JSON Schema completo.
`params.template.steps`	`esquema referenciado` Contiene Assembly Instructions. Los detalles adicionales del esquema están disponibles en el JSON Schema completo.
`params.template.template_id`	`string` Se ignora cuando se almacena en un Template. Los Templates no heredan Instructions de otro Template. Coloca los Steps directamente en este Template y selecciónalo usando `template_id` en los parámetros de nivel superior de la solicitud de la Assembly.
`params.template.usage_tags`	`string` Etiquetas de uso registradas en una Assembly.

string

string

Assembly Instructions codificadas en JSON que se conservan para mantener la compatibilidad con los clientes.

Patrón de validación (expresión regular)

^[\x09-\x0D\x20\xA0\u1680\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200a\u2028\u2029\u202f\u205f\u3000\ufeff]*\{(?:[^\x00]|\x00)*\}[\x09-\x0D\x20\xA0\u1680\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200a\u2028\u2029\u202f\u205f\u3000\ufeff]*$

params.transcoding_result_expiry

"1day" | "NoSave"

Controla cuánto tiempo se conservan los resultados de transcoding de las Assemblies creadas a partir de este Template.

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

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

Abrir JSON en una pestaña nueva

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

Utiliza las definiciones de campos indicadas arriba: params.assembly_status_expiry, params.auth, params.cron_auth_key_id, params.cron_enabled, params.cron_max_concurrent_runs, params.cron_region, params.cron_schedule_with_seconds, params.name, params.nonce, params.require_signature_auth, params.template, params.transcoding_result_expiry

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

Abrir JSON en una pestaña nueva

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

Utiliza las definiciones de campos indicadas arriba: params.assembly_status_expiry, params.cron_auth_key_id, params.cron_enabled, params.cron_max_concurrent_runs, params.cron_region, params.cron_schedule_with_seconds, params.name, params.nonce, params.require_signature_auth, params.template, params.transcoding_result_expiry

Campo	Tipo y descripción
`params.auth`	`object` Contiene la clave de API de Transloadit y los metadatos de Signature Authentication para una solicitud de Template. `params.auth`: Solo se aceptan los campos enumerados para este objeto.
`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.
`params.auth.key`	`string` Clave de API de Transloadit utilizada para autenticar solicitudes

Respuesta

Este es un ejemplo del cuerpo de la respuesta:

{
  "assembly_status_expiry": null,
  "content": {
    "steps": {
      "resize": {
        "robot": "/image/resize",
        "use": ":original",
        "width": 320
      }
    }
  },
  "id": "8fc3b9166c784afd824acf24269ebd11",
  "message": "Your Template was successfully created.",
  "name": "resize-images",
  "ok": "TEMPLATE_CREATED",
  "require_signature_auth": 0,
  "transcoding_result_expiry": null
}

éxito 2xx

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

Esquema del cuerpo de la respuesta

JSON Schema completo

Abrir JSON en una pestaña nueva

La respuesta contiene únicamente los campos listados para este objeto.

Campo	Tipo y descripción
`assembly_status_expiry` obligatorio	`null \| string`
`content` obligatorio	`object \| Array<cualquier valor> \| string \| number \| boolean \| null` Puede aplicarse cualquiera de los esquemas siguientes: object `object` Esquema de propiedades adicionales `cualquier valor` Array<cualquier valor> `Array<cualquier valor>` Esquema de los elementos del array `cualquier valor` `string` `number` `boolean` `null`
`cron_auth_key_id`	`string \| null` Patrón de validación (expresión regular) `^[a-f0-9]{32}$`
`cron_enabled`	`boolean`
`cron_max_concurrent_runs`	`integer` (mínimo: 1, máximo: 10)
`cron_region`	`"ap-southeast-1" \| "eu-west-1" \| "us-east-1" \| null`
`cron_schedule_with_seconds`	`string \| null` (longitud mínima: 1, longitud máxima: 255)
`id` obligatorio	`string` Puede aplicarse cualquiera de los esquemas siguientes: Variante 1: string (longitud máxima: 32) `string` Patrón de validación (expresión regular) `^[\x00-\x7F]*$` Variante 2: string (longitud máxima: 32) `string` Patrón de validación (expresión regular) `^builtin\/[a-z0-9-]+(?:@[0-9a-z.-]+)?$`
`message` obligatorio	`string` (longitud mínima: 1)
`name` obligatorio	`string` (longitud mínima: 1, longitud máxima: 255)
`ok` obligatorio	`string` (siempre: "TEMPLATE_CREATED")
`require_signature_auth` obligatorio	`0 \| 1`
`transcoding_result_expiry` obligatorio	`null \| string`

Respuesta de error

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

Esquema del cuerpo de la respuesta

JSON Schema completo

Abrir JSON en una pestaña nueva

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

La respuesta puede contener campos adicionales.

Campo	Tipo y descripción
`assembly_id`	`string`
`error`	`string` (longitud mínima: 1)
`http_code`	`number \| string` `number` `string` Patrón de validación (expresión regular) ^[\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` Explicación del error legible por humanos. Su redacción puede variar; usa el código `error` cuando manejes un fallo específico.
`reason`	`null \| string \| number \| boolean \| Array<cualquier valor> \| object` Puede aplicarse cualquiera de los esquemas siguientes: `null` `string` `number` `boolean` Array<cualquier valor> `Array<cualquier valor>` Esquema de los elementos del array `cualquier valor` object `object` Esquema de propiedades adicionales `cualquier valor`

HTTP 400

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

Esquema del cuerpo de la respuesta

JSON Schema completo

Abrir JSON en una pestaña nueva

Errores con nombre y el formato general de error

error: "TEMPLATE_VALIDATION_ERROR"

Tu Template no pasó la validación.

La respuesta puede contener campos adicionales.

Campo	Tipo y descripción
`error` obligatorio	`string` (siempre: "TEMPLATE_VALIDATION_ERROR")
`http_code`	`number` (siempre: 400)
`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

Consulta los campos generales de la respuesta de error.

Crear un nuevo Template

Ejemplo de solicitud

Autenticación

Campos del formulario

Claves admitidas dentro del campo params

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

Respuesta

éxito 2xx

Respuesta de error

HTTP 400

Claves admitidas dentro del campo `params`