Editar un Template

Actualiza un Template existente mediante su ID o nombre.

PUThttps://api2.transloadit.com/templates/{templateIdOrName}

Actualiza el Template representado por TEMPLATE_ID_OR_NAME. Los ajustes de nivel superior omitidos normalmente permanecen sin cambios, por lo que el ejemplo de solicitud siguiente cambia el nombre del Template sin modificar sus Instructions.

Al proporcionar template, se reemplazan por completo las Instructions almacenadas; no se combinan ni se modifican Steps individuales. Incluye en ese objeto todos los Steps y todas las Instructions que quieras conservar.

La programación mediante cron es una función en versión preliminar con acceso controlado. Cada Workspace participante puede habilitar un Template, con un máximo de 10.000 ticks admitidos por día UTC. Proporciona cron_region, un cron_schedule_with_seconds de seis campos y cron_auth_key_id antes de establecer cron_enabled en true. La Auth Key seleccionada debe pertenecer a este Workspace y permitir la creación de Assemblies. Quien realiza la llamada también debe tener permiso para crear Assemblies al habilitar o editar una programación activa. Deshabilitar la programación no requiere permiso para crear Assemblies. Si la programación deja de estar disponible o el Workspace pierde el acceso a la versión preliminar, una edición ordinaria del Template deshabilita automáticamente la programación, pero conserva su región, su horario, el ID de la Auth Key y la ejecución existente. Deshabilitar un Template o pausar su Workspace, su región o el programador impide futuras admisiones. Un tick ya admitido de forma duradera aún puede finalizar.

Las programaciones se ejecutan en UTC y deben mantener una separación de al menos 10 segundos entre cada par de ticks consecutivos. Las Instructions deben usar importaciones HTTP o S3 autosuficientes y no pueden depender de archivos cargados a través de :original o /upload/handle. Las Assemblies programadas importan como máximo 1.000 archivos de entrada y respetan un límite max_number_of_files inferior si se ha definido. Los cambios de ejecución entran en vigor en el siguiente tick futuro. Los ticks perdidos se omiten. cron_max_concurrent_runs tiene el valor predeterminado 1; auméntalo hasta 10 para permitir ejecuciones programadas simultáneas. Los inicios pendientes y las ejecuciones sin resolver cuentan para el límite incluso tras editar el Template y durante los ciclos de deshabilitación y rehabilitación. Al alcanzar el límite, los ticks se omiten con el resultado y el motivo overlap; no se ponen en cola para más adelante. Reducir el límite no cancela las ejecuciones existentes. Las Assemblies manuales no cuentan para este límite, y los límites habituales del Workspace siguen aplicándose. Este ajuste no deduplica los archivos importados. Un inicio consumido sin un punto de control de Assembly conserva su cupo hasta que vence su tiempo de espera configurable, cuyo valor predeterminado es de 10 minutos. Entonces se marca como lost con el motivo start_checkpoint_missing, lo que permite que los ticks posteriores continúen. Ese tick nunca se reintenta. Una Assembly que permanezca caída sin un punto de control de recuperación durante ese mismo tiempo de espera pasa a lost con el motivo recovery_checkpoint_missing, lo que también permite que los ticks futuros continúen. Las Assemblies abortadas o fallidas siguen contando para el solapamiento hasta que finalizan sus Jobs. Si nunca llega un punto de control final, caducan una vez transcurrido el tiempo de vida máximo de una Assembly del Workspace más el período de gracia para el punto de control; a continuación, utilizan el mismo tiempo de espera acotado para declararse perdidas, sin reiniciar el trabajo abortado o fallido. Un punto de control de Assembly tardío corrige el resultado conservado con el motivo start_checkpoint_late. Las ejecuciones perdidas liberan sus cupos de forma permanente. Por lo tanto, una Assembly tardía puede superar temporalmente el límite configurado, incluido el valor predeterminado de 1; esto no es un mecanismo estricto de exclusión mutua de ejecución.

Ejemplo de solicitud

Establece TEMPLATE_ID_OR_NAME en el valor de tu recurso sin aplicarle codificación porcentual.

Ejecuta esta solicitud en una consola del lado del servidor con curl y un token Bearer adecuado en TRANSLOADIT_TOKEN. Si necesitas un token, despliega la configuración siguiente.

¿Necesitas un token Bearer?

En una consola de confianza del lado del servidor con curl y jq, establece TRANSLOADIT_KEY y TRANSLOADIT_SECRET en 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 consola y ejecuta la solicitud siguiente. Reutiliza el token mientras siga siendo válido.

curl --fail-with-body -sS --request PUT \
  --url "https://api2.transloadit.com/templates/${TEMPLATE_ID_OR_NAME:?Set TEMPLATE_ID_OR_NAME}" \
  --header "Authorization: Bearer ${TRANSLOADIT_TOKEN:?Set TRANSLOADIT_TOKEN}" \
  --data-urlencode 'params={"name":"resized-images"}'

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.

Parámetros de ruta

templateIdOrName (segmento de ruta), obligatorio. patrón: ^[a-z0-9-]+$, longitud mínima: 1

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

Activa o desactiva la vista previa de Cron Template. Para activar o editar una programación activa, quien realiza la llamada debe tener permiso para crear Assemblies. Si se omite, se conserva la configuración actual mientras la programación siga disponible; una edición normal desactiva automáticamente la programación si se revoca el acceso a la vista previa. Cada Workspace que cumpla los requisitos puede activar un Cron Template. Las Instructions deben ser autocontenidas y usar importaciones HTTP o S3 sin :original ni /upload/handle. Se omiten las ejecuciones programadas que se hayan perdido, y se omite una ejecución programada cuando el Template alcanza su límite de ejecuciones simultáneas.

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

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

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

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 updated.",
  "name": "resized-images",
  "ok": "TEMPLATE_UPDATED",
  "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_UPDATED")
`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.

Editar un Template

Ejemplo de solicitud

Autenticación

Parámetros de ruta

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`