Crear una nueva Assembly

Crea una Assembly a partir de archivos subidos y Assembly Instructions.

POSThttps://api2.transloadit.com/assemblies

Flujo de trabajo habitual:

Envía el ejemplo de solicitud que aparece a continuación con tu archivo y las Instructions de procesamiento. Para recibir el estado final a través de un webhook, incluye notify_url en esas Instructions antes de enviar la solicitud.
Mantén en secreto el valor de assembly_ssl_url devuelto. Úsalo para consultar el progreso, o espera al webhook que has configurado.
Espera a que aparezca ok: "ASSEMBLY_COMPLETED" antes de utilizar los archivos procesados. Ni un error ni una cancelación constituyen un procesamiento satisfactorio. Los archivos de salida se agrupan por nombre de Step en results; consulta los campos de la respuesta.

Las Assemblies que usan /transloadit/import, directamente o a través de un Template, requieren un token Bearer o el valor de params firmado con una marca de tiempo futura en params.auth.expires. Esto se aplica incluso cuando Signature Authentication está desactivada en el Workspace. Una Auth Key por sí sola no es suficiente; las solicitudes autenticadas con un token Bearer no necesitan una Signature ni una caducidad por separado.

Una Assembly puede procesar y exportar archivos. Las Assembly Instructions determinan cómo debemos procesarlos. Las Instructions se pueden pasar directamente (dentro de un parámetro steps) o guardar en un Template (al que se hace referencia en un parámetro template_id). Los Templates te permiten reutilizar las Instructions, modificarlas sin desplegar tu aplicación y no exponer ningún secreto en el entorno donde se despliega tu aplicación.

Aceptamos solicitudes POST multipart/form-data para admitir las cargas habituales mediante <form> a nuestro servicio (así como el uso de XHR / SDK).

Se pueden incluir varios archivos como parte de esta solicitud. Si quieres realizar cargas de archivos reanudables, los archivos no se incluyen en esta solicitud, tal como se describe en Cargas reanudables.

Nota

Transloadit admite tamaños de archivo de hasta 200 GB. Si necesitas un límite superior para tu aplicación, ponte en contacto con nosotros.

Ejemplo de solicitud

Ejecuta esta solicitud en un shell del lado del servidor con curl y un token Bearer adecuado en TRANSLOADIT_TOKEN. Si necesitas un token, despliega la configuración que aparece a continuación.

Coloca tu archivo de entrada en ./example.jpg antes de ejecutar la solicitud.

¿Necesitas un token Bearer?

En un shell de confianza del lado del servidor con curl y jq, asigna tu Auth Key a TRANSLOADIT_KEY y tu Auth Secret a TRANSLOADIT_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=assemblies: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 este shell abierto 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/assemblies" \
  --header "Authorization: Bearer ${TRANSLOADIT_TOKEN:?Set TRANSLOADIT_TOKEN}" \
  --form-string 'params={"steps":{"resize":{"robot":"/image/resize","use":":original","width":320}}}' \
  --form 'file=@./example.jpg'

Qué ocurre después

Una respuesta HTTP satisfactoria indica que se ha aceptado la Assembly; no significa que el procesamiento haya finalizado. Una respuesta inicial puede tener este aspecto (fragmento; los IDs y las URLs serán diferentes):

{
  "ok": "ASSEMBLY_EXECUTING",
  "assembly_id": "0fce5b1063e611e88d8eb130f7921d8a",
  "assembly_ssl_url": "https://api2-morven.transloadit.com/assemblies/0fce5b1063e611e88d8eb130f7921d8a",
  "results": {}
}

Copia assembly_ssl_url de tu respuesta y consulta su estado cada pocos segundos, o usa un webhook configurado antes de la creación. Mantén esa URL en secreto. Detente si hay un error o una cancelación; ninguno de los dos constituye un procesamiento satisfactorio.

Cuando ok sea ASSEMBLY_COMPLETED, la salida de este ejemplo estará en results.resize. Una respuesta al completarse la Assembly incluye los siguientes campos (fragmento; la URL de salida es ilustrativa):

{
  "ok": "ASSEMBLY_COMPLETED",
  "message": "The Assembly was successfully completed.",
  "assembly_id": "0fce5b1063e611e88d8eb130f7921d8a",
  "results": {
    "resize": [
      {
        "name": "example.jpg",
        "mime": "image/jpeg",
        "ssl_url": "https://example.com/temporary-output/example.jpg",
        "meta": {
          "width": 320
        }
      }
    ]
  }
}

Usa results.resize[0].ssl_url para descargar la imagen redimensionada. Estas URLs temporales de salida caducan; añade un Step de exportación como /s3/store si necesitas conservar los archivos.

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: assemblies:write.

Las solicitudes autenticadas con una clave requieren una firma cuando Signature Authentication está activada. Los tokens Bearer no requieren una firma separada.

Parámetros opcionales de consulta de la respuesta

callback (Nombre del callback de JavaScript). Envuelve las respuestas JSON en un callback JSONP. El nombre del callback debe coincidir con ^(?:_jqjsp[0-9]*|jQuery[0-9]+_[0-9]+)$. Solo se utiliza la última aparición; los valores vacíos se ignoran. Los nombres de callback no válidos devuelven HTTP 403. La respuesta transformada utiliza HTTP 200. El callback se aplica después de serializar la respuesta.

Campos de formulario multipart

Tipo de contenido: multipart/form-data

params (cadena JSON), obligatorio. Un objeto codificado en JSON cuyas claves compatibles se enumeran a continuación.
signature (cadena). Obligatorio cuando la solicitud usa Signature Authentication.
num_expected_upload_files (campo de formulario). Cuando se usan subidas reanudables, especifica la cantidad de archivos que se subirán. Encontrarás más detalles en Subidas reanudables.
tus_num_expected_upload_files (campo de formulario). Alias heredado de num_expected_upload_files, conservado por compatibilidad con SDK antiguos.
* (binario o cadena). Los archivos binarios y los campos adicionales de la Assembly pueden usar nombres de campo arbitrarios.

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

Parámetros firmados utilizados para crear una Assembly a partir de Steps directos o de un Template.

Campo	Tipo y descripción
`params.auth` obligatorio para las solicitudes firmadas; opcional con un token Bearer	`object` Metadatos de autenticación y restricciones de carga para una solicitud firmada de Assembly. La clave de API es obligatoria. Contiene, como mínimo, tu Auth Key de Transloadit en la propiedad `key`. Si activas Signature Authentication, también debes establecer una fecha de caducidad para la solicitud en la propiedad expires: `{ "key": "23c96d084c744219a2ce156772ec3211", "expires": "YOUR_FUTURE_ISO_8601_TIMESTAMP" }` Recomendamos encarecidamente incluir un valor `params.nonce` generado aleatoriamente para cada solicitud en el nivel superior de `params`. Esto hace que las Signatures generadas de forma independiente sean distintas y evita su reutilización accidental. Un `nonce` no hace que los reintentos sean idempotentes: reintentar una solicitud de creación de una Assembly puede crear otra Assembly. Gestiona la deduplicación de los reintentos en tu aplicación cuando sea necesario. No reutilices `params` firmados entre endpoints. Las lecturas de Templates, los listados de Auth Keys, los listados de credenciales de Template y las lecturas de facturación rechazan, con `SIGNATURE_REUSE_DETECTED`, las Signatures ya registradas para otro endpoint o utilizadas para crear una Assembly. Genera nuevos params firmados para cada solicitud. `{ "auth": { "key": "23c96d084c744219a2ce156772ec3211", "expires": "YOUR_FUTURE_ISO_8601_TIMESTAMP" }, "nonce": "04ac6cb6-df43-41fb-a7fd-e5dd711a64e1" }` La propiedad `referer` es una expresión regular que se compara con el referer HTTP de esta carga, como `"example\.org"`. Úsala para comprobar que los valores de Referer proporcionados coincidan con un dominio esperado. Las cargas sin referer siempre superarán la comprobación (ya que algunos navegadores lo desactivan), por lo que esta opción solo resulta útil en unos pocos casos de uso. Para obtener más información sobre las expresiones regulares, consulta la documentación de RegExp de Mozilla. Se rechazan las expresiones regulares no válidas y las que superan el límite de tiempo de evaluación. Esta comprobación no sustituye a Signature Authentication: los clientes pueden omitir o falsificar la cabecera Referer. La propiedad `max_size` limita el tamaño total de carga previsto de la Assembly en bytes, como `1048576` (1 MB), en lugar de limitar cada archivo por separado. Esto incluye el cuerpo de la solicitud multipart, o los bytes de la solicitud inicial de la Assembly más sus cargas reanudables. Si se supera el límite, se detiene toda la Assembly con un error, incluidos los archivos que individualmente no superan el límite. No confíes en este límite para rechazar todas las transferencias de tamaño excesivo antes de que comiencen. En las cargas reanudables, el tamaño declarado o recibido pasa a estar disponible mediante las actualizaciones de tus, y la Assembly comprueba el límite cuando se procesa una carga finalizada. El tamaño de una carga diferida no se conoce en el momento de su creación, y es posible que ya se hayan transferido bytes antes de que la Assembly la rechace. Si solo quieres ignorar los archivos que superen un tamaño determinado, pero procesar todos los demás, usa 🤖/file/filter. La propiedad `max_number_of_files` permite establecer el número máximo de archivos que puede contener una carga, como `100`. Especifícala para evitar que los usuarios carguen demasiados archivos, tanto mediante cargas de archivos como mediante Robots de importación. Estas propiedades se pueden establecer como parte de la solicitud de Assembly o como parte del 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` obligatorio	`string` Clave de API de Transloadit utilizada para autenticar solicitudes
`params.auth.max_number_of_files`	`integer` (mínimo: 1) Número máximo de archivos de entrada permitidos por Assembly. Si la cantidad de archivos subidos o importados supera este límite, la Assembly se detiene con un error. Es útil para evitar abusos cuando se exponen las credenciales de Signature Authentication.
`params.auth.max_size`	`number` Tamaño total máximo de carga previsto para la Assembly, en bytes, incluida la sobrecarga del cuerpo de la solicitud. No es un límite por archivo y no garantiza el rechazo antes de que comience una transferencia reanudable.
`params.auth.referer`	`string` Expresión regular que se compara con el HTTP Referer proporcionado. Se rechazan las expresiones no válidas y las que superan el límite de tiempo de evaluación. Las solicitudes sin encabezado Referer superan esta comprobación; usa Signature Authentication para autenticar las solicitudes.
`params.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.exiftool_stack`	`string` Selecciona la pila de ExifTool para la extracción de metadatos en esta Assembly. Esto no selecciona la pila de procesamiento para los Steps de los Robots.
`params.ffmpeg_stack`	`string` Selecciona la pila de FFmpeg para la extracción de metadatos en esta Assembly. Esto no selecciona la pila de procesamiento de los Steps de Robot. Establece `ffmpeg_stack` en el Step de Robot correspondiente para seleccionar su pila de procesamiento.
`params.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 Esquema de propiedades adicionales `cualquier valor`
`params.imagemagick_stack`	`string` Selecciona la pila de ImageMagick para la extracción de metadatos en esta Assembly. Esto no selecciona la pila de procesamiento de los Steps de los Robots. Establece `imagemagick_stack` en el Step de Robot correspondiente para seleccionar su pila de procesamiento.
`params.mediainfo_stack`	`string` Selecciona la pila de MediaInfo para la extracción de metadatos en esta Assembly. Esto no selecciona la pila de procesamiento para los Steps de Robot.
`params.mplayer_stack`	`string` Selecciona la pila de MPlayer para la extracción de metadatos en esta Assembly. Esto no selecciona la pila de procesamiento para los Steps de Robot.
`params.nonce`	`string \| number` 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.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. Esquema de los elementos del array `"without_params" \| "without_result_meta_data" \| "without_results" \| "without_upload_meta_data" \| "without_uploads"`
`params.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.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.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.response_headers`	`object` Encabezados de respuesta personalizados emitidos por una Assembly. Las modificaciones de CORS deben definirse en `cors`; las demás claves de nivel superior se emiten como encabezados personalizados. `params.response_headers`: Se aceptan campos adicionales a los enumerados para este objeto.
`params.response_headers.cors`	`object` Los detalles adicionales del esquema están disponibles en el JSON Schema completo.
`params.usage_tags`	`string` Etiquetas de uso registradas en una Assembly.

Puede aplicarse cualquiera de los esquemas siguientes:

propiedades obligatorias: steps, template_id

Parámetros utilizados para crear una Assembly a partir de Steps directos o de un Template.

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

Campo	Tipo y descripción
`params.steps` obligatorio	`object` Valores parciales de Step que se combinan con los Steps correspondientes del Template almacenado. Su estructura completa específica de cada Robot se valida después de cargar el Template. Esquema de propiedades adicionales `object` Los detalles adicionales del esquema están disponibles en el JSON Schema completo.
`params.template_id` obligatorio	`string` (longitud mínima: 1) El ID del Template que contiene tus Assembly Instructions. Si estableces `allow_steps_override` en `false` en tu Template, entonces `steps` y `template_id` serán mutuamente excluyentes: solo podrás proporcionar uno de estos parámetros.

Variante 2

Parámetros utilizados para crear una Assembly a partir de Steps directos o de un Template.

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

Campo	Tipo y descripción
`params.steps`	`object` Contiene Assembly Instructions. Esquema de propiedades adicionales `object` Los detalles adicionales del esquema están disponibles en el JSON Schema completo.
`params.template_id`	`string` El ID del Template que contiene tus Assembly Instructions. Si estableces `allow_steps_override` en `false` en tu Template, entonces `steps` y `template_id` serán mutuamente excluyentes: solo podrás proporcionar uno de estos parámetros.

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

Parámetros firmados utilizados para crear una Assembly a partir de Steps directos o de un Template.

Utiliza las definiciones de campos indicadas arriba: params.auth, params.emit_execution_progress, params.exiftool_stack, params.ffmpeg_stack, params.fields, params.imagemagick_stack, params.mediainfo_stack, params.mplayer_stack, params.nonce, params.notification_payload, params.notify_url, params.quiet, params.redirect_url, params.response_headers, params.usage_tags

Puede aplicarse cualquiera de los esquemas siguientes:

propiedades obligatorias: steps, template_id

Parámetros utilizados para crear una Assembly a partir de Steps directos o de un Template.

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

Utiliza las definiciones de campos indicadas arriba: params.steps, params.template_id

Variante 2

Parámetros utilizados para crear una Assembly a partir de Steps directos o de un Template.

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

Utiliza las definiciones de campos indicadas arriba: params.steps, params.template_id

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

Parámetros utilizados para crear una Assembly a partir de Steps directos o de un Template.

Utiliza las definiciones de campos indicadas arriba: params.emit_execution_progress, params.exiftool_stack, params.ffmpeg_stack, params.fields, params.imagemagick_stack, params.mediainfo_stack, params.mplayer_stack, params.nonce, params.notification_payload, params.notify_url, params.quiet, params.redirect_url, params.response_headers, params.usage_tags

Campo	Tipo y descripción
`params.auth`	`object` Metadatos de autenticación y restricciones de carga para una solicitud de Assembly autenticada con un token Bearer. El token proporciona la clave de API, por lo que la solicitud puede omitirla. La propiedad `referer` es una expresión regular que se compara con el referer HTTP de esta carga, como `"example\.org"`. Úsala para comprobar que los valores de Referer proporcionados coincidan con un dominio esperado. Las cargas sin referer 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 más información sobre las expresiones regulares, consulta la documentación de RegExp de Mozilla. Se rechazan las expresiones regulares no válidas y las que superan el límite de tiempo de evaluación. Esta comprobación no sustituye a Signature Authentication: los clientes pueden omitir o falsificar la cabecera Referer. La propiedad `max_size` limita el tamaño total de carga esperado de la Assembly en bytes, como `1048576` (1 MB), en lugar de limitar cada archivo por separado. Esto incluye el cuerpo de la solicitud multipart, o los bytes de la solicitud inicial de la Assembly más sus cargas reanudables. Si se supera el límite, se detiene toda la Assembly con un error, incluidos los archivos que individualmente no superan el límite. No confíes en que este límite rechace todas las transferencias de tamaño excesivo antes de que comiencen. En las cargas reanudables, el tamaño declarado o recibido pasa a estar disponible a través de las actualizaciones de tus, y la Assembly comprueba el límite cuando se procesa una carga finalizada. El tamaño de una carga diferida no se conoce en el momento de su creación, y es posible que ya se hayan transferido bytes antes de que la Assembly la rechace. Si solo quieres ignorar los archivos que superen un tamaño determinado, pero procesar todos los demás, usa 🤖/file/filter. La propiedad `max_number_of_files` se puede usar para establecer el número máximo de archivos que puede contener una carga, como `100`. Especifícala para impedir que los usuarios carguen una cantidad excesiva de archivos, tanto mediante cargas de archivos como mediante Robots de importación. Estas propiedades se pueden establecer como parte de la solicitud de Assembly o como parte del 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
`params.auth.max_number_of_files`	`integer` (mínimo: 1) Número máximo de archivos de entrada permitidos por Assembly. Si la cantidad de archivos subidos o importados supera este límite, la Assembly se detiene con un error. Es útil para evitar abusos cuando se exponen las credenciales de Signature Authentication.
`params.auth.max_size`	`number` Tamaño total máximo de carga previsto para la Assembly, en bytes, incluida la sobrecarga del cuerpo de la solicitud. No es un límite por archivo y no garantiza el rechazo antes de que comience una transferencia reanudable.
`params.auth.referer`	`string` Expresión regular que se compara con el HTTP Referer proporcionado. Se rechazan las expresiones no válidas y las que superan el límite de tiempo de evaluación. Las solicitudes sin encabezado Referer superan esta comprobación; usa Signature Authentication para autenticar las solicitudes.

Puede aplicarse cualquiera de los esquemas siguientes:

propiedades obligatorias: steps, template_id

Parámetros utilizados para crear una Assembly a partir de Steps directos o de un Template.

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

Utiliza las definiciones de campos indicadas arriba: params.steps, params.template_id

Variante 2

Parámetros utilizados para crear una Assembly a partir de Steps directos o de un Template.

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

Utiliza las definiciones de campos indicadas arriba: params.steps, params.template_id

También puedes proporcionar aquí otros campos POST (que no se llamen params, signature, num_expected_upload_files ni tus_num_expected_upload_files). Puedes usarlos como variables para hacer dinámicas tus Assembly Instructions.

Respuesta

Este es un ejemplo del cuerpo de la respuesta:

{
  "account_id": "6c8b8d10d68b11e3a799b579dfce333a",
  "assembly_id": "0fce5b1063e611e88d8eb130f7921d8a",
  "assembly_ssl_url": "https://api2-morven.transloadit.com/assemblies/0fce5b1063e611e88d8eb130f7921d8a",
  "assembly_url": "http://api2.morven.transloadit.com/assemblies/0fce5b1063e611e88d8eb130f7921d8a",
  "bytes_expected": 1687,
  "bytes_received": 1687,
  "bytes_usage": 0,
  "companion_url": "https://api2-morven.transloadit.com/companion/",
  "execution_duration": 0.001,
  "execution_start": "2018/05/30 08:47:19 GMT",
  "fields": {},
  "instance": "morven.transloadit.com",
  "jobs_queue_duration": 0,
  "message": "The Assembly is currently being executed.",
  "ok": "ASSEMBLY_EXECUTING",
  "parent_id": null,
  "queue_duration": 0.04,
  "results": {},
  "start_date": "2018/05/30 08:47:19 GMT",
  "template": null,
  "template_id": null,
  "tus_url": "https://api2-morven.transloadit.com/resumable/files/",
  "update_stream_url": "https://api2-morven.transloadit.com/ws20243?assembly=0fce5b1063e611e88d8eb130f7921d8a",
  "upload_duration": 0.049,
  "uploads": [],
  "uppyserver_url": "https://api2-morven.transloadit.com/companion/",
  "warnings": [],
  "websocket_url": "https://api2-morven.transloadit.com/ws20243"
}

é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

Campo Tipo y descripción

null | string

null | string

null | string

null | string

string

string

El ID único de esta Assembly. Puedes almacenarlo en una base de datos cuando se crea una Assembly y usarlo para relacionar las Notifications entrantes.

assembly_ssl_url

null | string

La URL única que se utiliza para consultar el estado actual de esta Assembly, pero preparada para usarse mediante SSL/HTTPS. Todas las solicitudes a la API que se envían a assembly_url también pueden enviarse a assembly_ssl_url.

assembly_url

null | string

La URL única que se utiliza para consultar el estado actual de esta Assembly.

build_id

string

Identificador de compilación opcional para que el equipo de soporte pueda investigar problemas. Trátalo como un valor opaco; puede cambiar entre Assemblies.

bytes_expected

number

La cantidad de bytes que esta Assembly espera que se suban.

bytes_received

number

La cantidad de bytes que se han subido hasta el momento a esta Assembly. Los clientes utilizan este valor principalmente para mostrar el progreso de la subida.

bytes_usage

number | null

La cantidad total de bytes procesados por esta Assembly que se contabilizan en tu factura de uso. La suma de bytes_usage de todas tus Assemblies equivale a tu uso mensual total.

client_agent

null | string

El agente de usuario de quien realiza la subida no se expone; este campo obsoleto siempre es null.

client_ip

null | string

La dirección IP de quien realiza la subida no se expone; este campo obsoleto siempre es null.

client_referer

null | string

La URL de referencia de quien realiza la subida no se expone; este campo obsoleto siempre es null.

companion_url

null | string

La URL del servidor Companion con el que esta Assembly puede comunicarse.

executing_jobs

Array<string>

Esquema de los elementos del array

string

execution_duration

number | null

El tiempo que tardó Transloadit en ejecutar esta Assembly, en segundos.

execution_start

null | string

expected_tus_uploads

number

fields

object

Un mapa de claves y valores de cualquier campo adicional presente en tu formulario, para integraciones que no pueden usar la encapsulación <form> (como Uppy).

Esquema de propiedades adicionales

cualquier valor

finished_tus_uploads

number

has_dupe_jobs

boolean

ignored_error_count

number

ignored_errors

Array<object>

Esquema de los elementos del array

object

ignored_errors[]: La respuesta puede contener campos adicionales.

Campo	Tipo y descripción
`ignored_errors[].error`	`cualquier valor`
`ignored_errors[].message`	`string`
`ignored_errors[].phase`	`string`
`ignored_errors[].step`	`null \| string`

info

object

info: La respuesta puede contener campos adicionales.

info.retryIn

number

instance

null | string

is_infinite

boolean

jobs_queue_duration

number

last_job_completed

null | string

merged_params

null | string

message

string

Un mensaje legible que explica el estado de esta Assembly. No siempre está presente.

notify_duration

number | null

Tiempo transcurrido durante la entrega, en segundos, incluidos los reintentos automáticos y las esperas entre ellos.

notify_error

null | string

notify_response_code

number | null

notify_response_data

null | string

null | string

null | string

null | string

number

params

null | string

parent_assembly_status

cualquier valor | null

Puede aplicarse cualquiera de los esquemas siguientes:

cualquier valor

cualquier valor

null

parent_id

null | string

previousStep

string

Nombre del Step anterior relacionado con el error, cuando esté disponible.

queue_duration

number

region

string

results

object

Los archivos de resultados que Transloadit ha producido hasta el momento. Cada clave de este objeto es el nombre del Step que produjo un archivo específico. Como los Robots de almacenamiento no producen archivos, los nombres de sus Steps no se incluyen aquí. Si se produce un error, puede contener resultados parciales.

Esquema de propiedades adicionales

Array<object>

Los detalles adicionales del esquema están disponibles en el JSON Schema completo.

running_jobs

Array<string>

Esquema de los elementos del array

string

start_date

string

La fecha y hora en que comenzó la subida para esta Assembly.

started_jobs

Array<string>

Esquema de los elementos del array

string

started_tus_uploads

number

step

string

Nombre del Step relacionado con el error, cuando esté disponible.

null | string

null | string

null | string

null | string

Array<object>

Esquema de los elementos del array

object

tus_uploads[]: La respuesta puede contener campos adicionales.

Campo	Tipo y descripción
`tus_uploads[].fieldname` obligatorio	`string`
`tus_uploads[].filename` obligatorio	`string`
`tus_uploads[].finished` obligatorio	`boolean`
`tus_uploads[].offset` obligatorio	`number`
`tus_uploads[].size` obligatorio	`number`
`tus_uploads[].upload_url` obligatorio	`string`
`tus_uploads[].user_meta`	`object` Los detalles adicionales del esquema están disponibles en el JSON Schema completo.

tus_url

string

La URL del servidor tus que utiliza esta Assembly para las subidas reanudables.

update_stream_url

null | string

La URL de un flujo de eventos enviados por el servidor desde el que puedes obtener actualizaciones de estado en tiempo real de esta Assembly.

upload_duration

number

El tiempo que tardó quien realizó la subida en subir los archivos, en segundos.

upload_meta_data_extracted

boolean

uploads

Array<object>

Un arreglo de archivos subidos para esta Assembly. Para obtener más información, consulta la documentación de metadatos.

Esquema de los elementos del array

object

Campo	Tipo y descripción
`uploads[].as`	`string \| Array<string> \| null` Los detalles adicionales del esquema están disponibles en el JSON Schema completo.
`uploads[].asset_id`	`string` Identidad estable de un archivo almacenado mediante `/transloadit/store`. Consérvala junto con su Workspace y `version_id`; el `id` habitual del archivo no es un ID de activo de Storage.
`uploads[].asset_version`	`number` Revisión numérica del activo almacenado. Usa `version_id`, no este número, para seleccionar los bytes exactos que se conservan.
`uploads[].cost`	`number \| null`
`uploads[].exec_time`	`number`
`uploads[].from_batch_import`	`boolean`
`uploads[].has_alpha`	`boolean` Indica si esta versión almacenada de la imagen tiene un canal alfa, cuando se conoce.
`uploads[].import_url`	`string`
`uploads[].is_temp_url`	`boolean`
`uploads[].is_tus_file`	`boolean`
`uploads[].md5hash`	`null \| string`
`uploads[].original_basename`	`null \| string`
`uploads[].original_id` obligatorio	`string \| Array<null \| string>` El ID único del archivo subido originalmente a partir del cual se generó este archivo. Permite determinar qué archivo de una subida múltiple se utilizó para generar un archivo determinado, después de varios Steps de procesamiento. Los detalles adicionales del esquema están disponibles en el JSON Schema completo.
`uploads[].original_md5hash`	`null \| string`
`uploads[].original_name`	`null \| string`
`uploads[].original_path`	`string`
`uploads[].queue`	`null \| string`
`uploads[].queue_time`	`number`
`uploads[].sha256`	`string` Suma de comprobación SHA-256 en minúsculas de los bytes almacenados, cuando esté disponible. Patrón de validación (expresión regular) `^[a-f0-9]{64}$`
`uploads[].ssl_url`	`null \| string`
`uploads[].thumbhash`	`string` ThumbHash codificado en Base64 conservado junto con esta versión almacenada de la imagen, cuando esté disponible. Protege estos datos de imagen con los mismos controles de acceso que la imagen original. Patrón de validación (expresión regular) `^(?:[A-Za-z0-9+/]{4}){1,15}(?:[A-Za-z0-9+/]{4}\|[A-Za-z0-9+/]{2}==\|[A-Za-z0-9+/]{3}=)$`
`uploads[].tus_upload_url`	`null \| string`
`uploads[].user_meta`	`object` Los detalles adicionales del esquema están disponibles en el JSON Schema completo.
`uploads[].version_id`	`string` ID de versión inmutable devuelto después de que el almacenamiento finalice el resultado. Importa con `asset_id` y este `version_id` para conservar los mismos bytes tras un traslado o una sobrescritura, con sujeción a la retención y al acceso. Patrón de validación (expresión regular) `^[A-Za-z0-9_-]{21}[AQgw]$`
`uploads[].workspace`	`string` (longitud mínima: 1) Slug del Workspace al que pertenece este resultado almacenado. Autentícate para este Workspace al importarlo o gestionarlo.

Puede aplicarse cualquiera de los esquemas siguientes:

propiedades obligatorias: basename, ext, field, id, meta, mime, name, size, type, url: object

object

uploads[]: La respuesta puede contener campos adicionales.

Campo	Tipo y descripción
`uploads[].basename` obligatorio	`null \| string` El nombre del archivo sin la extensión.
`uploads[].ext` obligatorio	`null \| string` La extensión del archivo. Puede ser `null` cuando no se haya determinado una extensión, o una cadena vacía si el nombre no tiene extensión.
`uploads[].field` obligatorio	`null \| string` El nombre del campo de formulario utilizado para enviar este archivo.
`uploads[].id` obligatorio	`string` Un ID aleatorio y único que Transloadit utiliza internamente para identificar el archivo.
`uploads[].meta` obligatorio	`object` Un objeto que contiene metadatos adicionales extraídos del archivo, como se muestra a continuación. Las etiquetas de fecha repetidas pueden devolverse como listas de sus valores originales. Comprueba el tipo del valor antes de usarlo como una única marca de tiempo. Los detalles adicionales del esquema están disponibles en el JSON Schema completo.
`uploads[].mime` obligatorio	`null \| string` El tipo MIME determinado para este archivo.
`uploads[].name` obligatorio	`null \| string` El nombre del archivo. Transloadit cambia la extensión utilizada en este campo si el archivo se procesa y se convierte a otro formato.
`uploads[].size` obligatorio	`number` El tamaño del archivo, en bytes.
`uploads[].type` obligatorio	`null \| string` Una categoría abstracta que describe el archivo. Los valores conocidos son `"audio"`, `"document"`, `"image"`, `"office"`, `"pdf"`, `"swf"`, `"video"`, `"xls"` o `null` cuando no se detectó ninguna categoría. Los clientes deben aceptar otras cadenas para mantener la compatibilidad con categorías futuras.
`uploads[].url` obligatorio	`null \| string` Una URL desde la que se puede descargar el archivo, o `null` cuando no hay ninguna URL de entrega disponible. Las URL temporales de nuestros servidores caducan al cabo de unas horas; exporta los archivos a un almacenamiento para usarlos más adelante. Los resultados de almacenamiento privado de `/transloadit/store` devuelven `null` tanto para `url` como para `ssl_url`. Conserva el Workspace, el `asset_id` y el `version_id` devueltos para disponer de una referencia duradera, sujeta al acceso y a la retención. `/transloadit/import` acepta `asset_id` con un `version_id` opcional, o un `path` mutable. Ni una URL temporal ni el `id` del archivo de procesamiento constituyen una referencia duradera al almacenamiento.

Variante 2: object

object

uploads[]: La respuesta puede contener campos adicionales.

Campo	Tipo y descripción
`uploads[].basename`	`null \| string` El nombre del archivo sin la extensión.
`uploads[].ext`	`null \| string` La extensión del archivo. Puede ser `null` cuando no se haya determinado una extensión, o una cadena vacía si el nombre no tiene extensión.
`uploads[].field`	`null \| string` El nombre del campo de formulario utilizado para enviar este archivo.
`uploads[].id`	`nunca` Este valor está prohibido.
`uploads[].meta`	`object` Un objeto que contiene metadatos adicionales extraídos del archivo, como se muestra a continuación. Las etiquetas de fecha repetidas pueden devolverse como listas de sus valores originales. Comprueba el tipo del valor antes de usarlo como una única marca de tiempo. Los detalles adicionales del esquema están disponibles en el JSON Schema completo.
`uploads[].mime`	`null \| string` El tipo MIME determinado para este archivo.
`uploads[].name`	`null \| string` El nombre del archivo. Transloadit cambia la extensión utilizada en este campo si el archivo se procesa y se convierte a otro formato.
`uploads[].size`	`number` El tamaño del archivo, en bytes.
`uploads[].type`	`null \| string` Una categoría abstracta que describe el archivo. Los valores conocidos son `"audio"`, `"document"`, `"image"`, `"office"`, `"pdf"`, `"swf"`, `"video"`, `"xls"` o `null` cuando no se detectó ninguna categoría. Los clientes deben aceptar otras cadenas para mantener la compatibilidad con categorías futuras.
`uploads[].url`	`null \| string` Una URL desde la que se puede descargar el archivo, o `null` cuando no hay ninguna URL de entrega disponible. Las URL temporales de nuestros servidores caducan al cabo de unas horas; exporta los archivos a un almacenamiento para usarlos más adelante. Los resultados de almacenamiento privado de `/transloadit/store` devuelven `null` tanto para `url` como para `ssl_url`. Conserva el Workspace, el `asset_id` y el `version_id` devueltos para disponer de una referencia duradera, sujeta al acceso y a la retención. `/transloadit/import` acepta `asset_id` con un `version_id` opcional, o un `path` mutable. Ni una URL temporal ni el `id` del archivo de procesamiento constituyen una referencia duradera al almacenamiento.

null | string

string

string

Array<object>

Esquema de los elementos del array

object

warnings[]: La respuesta puede contener campos adicionales.

Campo	Tipo y descripción
`warnings[].action`	`object` (propiedades obligatorias: message, text, type) Los detalles adicionales del esquema están disponibles en el JSON Schema completo.
`warnings[].level` obligatorio	`"notice" \| "warning"`
`warnings[].msg` obligatorio	`string`

websocket_url

null | string

La URL de un servidor Websocket (utiliza Socket.IO) desde el que puedes obtener actualizaciones en tiempo real sobre el estado de esta Assembly.

Puede aplicarse cualquiera de los esquemas siguientes:

ok: "ASSEMBLY_EXECUTING" | "ASSEMBLY_REPLAYING" | "ASSEMBLY_UPLOADING"

La respuesta puede contener campos adicionales.

Campo	Tipo y descripción
`error`	`nunca` Indica un estado de error. Esta clave solo está presente si la Assembly ha fallado. Es posible que se añadan nuevos códigos de error. Trata los códigos no reconocidos como fallos y conserva sus valores para inspeccionarlos mediante programación. Este valor está prohibido.
`ok` obligatorio	`"ASSEMBLY_EXECUTING" \| "ASSEMBLY_REPLAYING" \| "ASSEMBLY_UPLOADING"` Indica un estado del ciclo de vida sin error, incluidos los estados de subida, ejecución, solicitud abortada y Assembly cancelada. El procesamiento correcto se indica con `ASSEMBLY_COMPLETED`. Si la Assembly encontró un error, se utiliza la clave `error` que aparece a continuación en lugar de esta clave.

ok: string

La respuesta puede contener campos adicionales.

Campo Tipo y descripción

error

nunca

Indica un estado de error. Esta clave solo está presente si la Assembly ha fallado. Es posible que se añadan nuevos códigos de error. Trata los códigos no reconocidos como fallos y conserva sus valores para inspeccionarlos mediante programación.

Este valor está prohibido.

ok

obligatorio

string

Indica un estado del ciclo de vida sin error, incluidos los estados de subida, ejecución, solicitud abortada y Assembly cancelada. El procesamiento correcto se indica con ASSEMBLY_COMPLETED. Si la Assembly encontró un error, se utiliza la clave error que aparece a continuación en lugar de esta clave.

Valores permitidos (6)

"ASSEMBLY_CANCELED"
"ASSEMBLY_COMPLETED"
"ASSEMBLY_EXECUTING"
"ASSEMBLY_REPLAYING"
"ASSEMBLY_UPLOADING"
"REQUEST_ABORTED"

propiedades obligatorias: error

La respuesta puede contener campos adicionales.

Campo	Tipo y descripción
`cmd`	`string \| Array<string \| number>` Detalles opcionales del comando de procesamiento para investigar problemas. Los detalles de diagnóstico pueden variar; usa el código `error` para gestionar errores de forma programática. Puede aplicarse cualquiera de los esquemas siguientes: `string` Array<string \| number> `Array<string \| number>` Esquema de los elementos del array `string \| number`
`error` obligatorio	`string` (longitud mínima: 1) Indica un estado de error. Esta clave solo está presente si la Assembly ha fallado. Es posible que se añadan nuevos códigos de error. Trata los códigos no reconocidos como fallos y conserva sus valores para inspeccionarlos mediante programación. Valores conocidos (363); puede haber otros valores `"ADMIN_PERMISSIONS_REQUIRED"` `"AI_CHAT_VALIDATION"` `"ASSEMBLY_ACCOUNT_MISMATCH"` `"ASSEMBLY_CANNOT_BE_REPLAYED"` `"ASSEMBLY_COULD_NOT_BE_CREATED"` `"ASSEMBLY_CRASHED"` `"ASSEMBLY_DISALLOWED_ROBOTS_USED"` `"ASSEMBLY_EMPTY_STEPS"` `"ASSEMBLY_EXECUTION_PROGRESS_NOT_ENABLED"` `"ASSEMBLY_EXPIRED"` `"ASSEMBLY_FILE_NOT_RESERVED"` `"ASSEMBLY_INFINITE"` `"ASSEMBLY_INVALID_NOTIFY_URL"` `"ASSEMBLY_INVALID_NUM_EXPECTED_UPLOAD_FILES_PARAM"` `"ASSEMBLY_INVALID_STEPS"` `"ASSEMBLY_JOB_ENQUEUE_ERROR"` `"ASSEMBLY_LIST_ERROR"` `"ASSEMBLY_MEMORY_LIMIT_EXCEEDED"` `"ASSEMBLY_NOTIFICATIONS_LIST_ERROR"` `"ASSEMBLY_NOTIFICATION_LIST_ERROR"` `"ASSEMBLY_NOTIFICATION_NOT_PERSISTED"` `"ASSEMBLY_NOTIFICATION_NOT_REPLAYED"` `"ASSEMBLY_NOT_CAPABLE"` `"ASSEMBLY_NOT_FINISHED"` `"ASSEMBLY_NOT_FOUND"` `"ASSEMBLY_NOT_REPLAYED"` `"ASSEMBLY_NO_CHARGEABLE_STEP"` `"ASSEMBLY_NO_NOTIFY_URL"` `"ASSEMBLY_NO_STEPS"` `"ASSEMBLY_PLAN_FILE_SIZE_LIMIT_EXCEEDED"` `"ASSEMBLY_ROBOT_MISSING"` `"ASSEMBLY_SATURATED"` `"ASSEMBLY_STATS_ERROR"` `"ASSEMBLY_STATS_INVALID_TIME"` `"ASSEMBLY_STATS_MISSING_REGION"` `"ASSEMBLY_STATUS_FETCHING_RATE_LIMIT_REACHED"` `"ASSEMBLY_STATUS_NOT_FOUND"` `"ASSEMBLY_STATUS_PARSE_ERROR"` `"ASSEMBLY_STEP_INVALID"` `"ASSEMBLY_STEP_INVALID_ROBOT"` `"ASSEMBLY_STEP_INVALID_USE"` `"ASSEMBLY_STEP_NO_ROBOT"` `"ASSEMBLY_STEP_UNKNOWN_ROBOT"` `"ASSEMBLY_STEP_UNKNOWN_USE"` `"ASSEMBLY_URL_TRANSFORM_MISSING"` `"AUDIO_ARTWORK_VALIDATION"` `"AUDIO_CONCAT_INVALID_INPUT"` `"AUDIO_CONCAT_VALIDATION"` `"AUDIO_ENCODE_VALIDATION"` `"AUDIO_LOOP_VALIDATION"` `"AUDIO_MERGE_VALIDATION"` `"AUDIO_SPLIT_NO_OUTPUT"` `"AUDIO_SPLIT_VALIDATION"` `"AUDIO_WAVEFORM_VALIDATION"` `"AUTH_EXPIRED"` `"AUTH_KEYS_NOT_FOUND"` `"AUTH_KEY_SCOPES_NOT_FOUND"` `"AUTH_SECRET_NOT_RETRIEVED"` `"AZURE_IMPORT_ACCESS_DENIED"` `"AZURE_IMPORT_FAILURE"` `"AZURE_IMPORT_NOT_FOUND"` `"AZURE_IMPORT_VALIDATION"` `"AZURE_STORE_ACCESS_DENIED"` `"AZURE_STORE_NOT_FOUND"` `"AZURE_STORE_VALIDATION"` `"BACKBLAZE_IMPORT_ACCESS_DENIED"` `"BACKBLAZE_IMPORT_FAILURE"` `"BACKBLAZE_IMPORT_NOT_FOUND"` `"BACKBLAZE_IMPORT_VALIDATION"` `"BACKBLAZE_STORE_ACCESS_DENIED"` `"BACKBLAZE_STORE_FAILURE"` `"BACKBLAZE_STORE_VALIDATION"` `"BAD_PRICING"` `"BEARER_TOKEN_AUTH_KEY_MISMATCH"` `"BEARER_TOKEN_EXPIRED"` `"BEARER_TOKEN_INVALID"` `"BILL_LIMIT_EXCEEDED"` `"BOX_IMPORT_ACCESS_DENIED"` `"BOX_IMPORT_FAILURE"` `"BOX_IMPORT_NOT_FOUND"` `"BOX_IMPORT_VALIDATION"` `"BOX_STORE_COULD_NOT_PARSE_URL"` `"BOX_STORE_VALIDATION"` `"CANNOT_ACCEPT_NEW_ASSEMBLIES"` `"CDN_REQUIRED"` `"CLOUDFILES_IMPORT_ACCESS_DENIED"` `"CLOUDFILES_IMPORT_FAILURE"` `"CLOUDFILES_IMPORT_NOT_FOUND"` `"CLOUDFILES_IMPORT_VALIDATION"` `"CLOUDFILES_STORE_ACCESS_DENIED"` `"CLOUDFILES_STORE_ERROR"` `"CLOUDFILES_STORE_VALIDATION"` `"CLOUDFLARE_IMPORT_ACCESS_DENIED"` `"CLOUDFLARE_IMPORT_FAILURE"` `"CLOUDFLARE_IMPORT_NOT_FOUND"` `"CLOUDFLARE_IMPORT_VALIDATION"` `"CLOUDFLARE_STORE_ACCESS_DENIED"` `"CLOUDFLARE_STORE_NOT_FOUND"` `"CLOUDFLARE_STORE_URL_VERIFICATION_FAILURE"` `"CLOUDFLARE_STORE_VALIDATION"` `"CLOUDFLARE_STORE_WRONG_REGION"` `"CLOUD_AI_IMAGE_VALIDATION"` `"DAM_STORAGE_UNAVAILABLE"` `"DIGITALOCEAN_IMPORT_ACCESS_DENIED"` `"DIGITALOCEAN_IMPORT_FAILURE"` `"DIGITALOCEAN_IMPORT_NOT_FOUND"` `"DIGITALOCEAN_IMPORT_VALIDATION"` `"DIGITALOCEAN_STORE_ACCESS_DENIED"` `"DIGITALOCEAN_STORE_NOT_FOUND"` `"DIGITALOCEAN_STORE_VALIDATION"` `"DIGITALOCEAN_STORE_WRONG_REGION"` `"DOCUMENT_AUTOROTATE_VALIDATION"` `"DOCUMENT_CONVERT_UNSUPPORTED_CONVERSION"` `"DOCUMENT_CONVERT_VALIDATION"` `"DOCUMENT_EXTRACT_VALIDATION"` `"DOCUMENT_MERGE_UNSUPPORTED_CONVERSION"` `"DOCUMENT_MERGE_VALIDATION"` `"DOCUMENT_OCR_VALIDATION"` `"DOCUMENT_OPTIMIZE_UNSUPPORTED_INPUT"` `"DOCUMENT_OPTIMIZE_VALIDATION"` `"DOCUMENT_SPLIT_VALIDATION"` `"DOCUMENT_THUMBS_INVALID_INPUT"` `"DOCUMENT_THUMBS_VALIDATION"` `"DO_NOT_REUSE_ASSEMBLY_IDS"` `"DROPBOX_IMPORT_ACCESS_DENIED"` `"DROPBOX_IMPORT_FAILURE"` `"DROPBOX_IMPORT_NOT_FOUND"` `"DROPBOX_IMPORT_VALIDATION"` `"DROPBOX_STORE_COULD_NOT_PARSE_URL"` `"DROPBOX_STORE_VALIDATION"` `"FILE_COMPRESS_INVALID_INPUT"` `"FILE_COMPRESS_VALIDATION"` `"FILE_DECOMPRESS_INVALID_INPUT"` `"FILE_DECOMPRESS_PASSWORD_INCORRECT"` `"FILE_DECOMPRESS_PASSWORD_REQUIRED"` `"FILE_DECOMPRESS_VALIDATION"` `"FILE_DOWNLOAD_ERROR"` `"FILE_FILTER_DECLINED_FILE"` `"FILE_FILTER_INVALID_OPERATOR"` `"FILE_FILTER_VALIDATION"` `"FILE_HASH_VALIDATION"` `"FILE_META_DATA_ERROR"` `"FILE_PREVIEW_VALIDATION"` `"FILE_READ_VALIDATION_ERROR"` `"FILE_SERVE_NO_RESULT"` `"FILE_SERVE_VALIDATION"` `"FILE_VERIFY_INVALID_FILE"` `"FILE_VERIFY_VALIDATION"` `"FILE_VIRUSSCAN_DECLINED_FILE"` `"FILE_VIRUSSCAN_INVALID_INPUT"` `"FILE_VIRUSSCAN_VALIDATION"` `"FTP_IMPORT_ACCESS_DENIED"` `"FTP_IMPORT_FAILURE"` `"FTP_IMPORT_NOT_FOUND"` `"FTP_IMPORT_VALIDATION"` `"FTP_STORE_VALIDATION"` `"GET_ACCOUNT_DB_ERROR"` `"GET_ACCOUNT_UNKNOWN_AUTH_KEY"` `"GOOGLE_IMPORT_ACCESS_DENIED"` `"GOOGLE_IMPORT_FAILURE"` `"GOOGLE_IMPORT_NOT_FOUND"` `"GOOGLE_IMPORT_VALIDATION"` `"GOOGLE_STORE_INVALID_INPUT"` `"GOOGLE_STORE_VALIDATION"` `"HTML_CONVERT_VALIDATION"` `"HTTP_IMPORT_ACCESS_DENIED"` `"HTTP_IMPORT_FAILURE"` `"HTTP_IMPORT_NOT_FOUND"` `"HTTP_IMPORT_VALIDATION"` `"HTTP_REQUEST_FAILURE"` `"HTTP_REQUEST_VALIDATION"` `"IMAGE_BGREMOVE_VALIDATION"` `"IMAGE_COPYRIGHT_DETECT_DECLINED_FILE"` `"IMAGE_COPYRIGHT_DETECT_VALIDATION"` `"IMAGE_DESCRIBE_VALIDATION"` `"IMAGE_ENHANCE_NO_INPUT_FILE"` `"IMAGE_ENHANCE_VALIDATION"` `"IMAGE_FACEDETECT_VALIDATION"` `"IMAGE_GENERATE_VALIDATION"` `"IMAGE_MERGE_FAILURE"` `"IMAGE_MERGE_VALIDATION"` `"IMAGE_OCR_VALIDATION"` `"IMAGE_OPTIMIZE_VALIDATION"` `"IMAGE_RESIZE_ERROR"` `"IMAGE_RESIZE_INVALID_BLUR_REGION"` `"IMAGE_RESIZE_INVALID_TEXT_OBJECT_VALUE"` `"IMAGE_RESIZE_INVALID_TEXT_VALUE"` `"IMAGE_RESIZE_INVALID_WATERMARK_OFFSET"` `"IMAGE_RESIZE_INVALID_WATERMARK_POSITION"` `"IMAGE_RESIZE_NO_CLUT_FILE"` `"IMAGE_RESIZE_NO_INPUT_FILE"` `"IMAGE_RESIZE_VALIDATION"` `"IMAGE_UPSCALE_VALIDATION"` `"IMPORT_FILE_ERROR"` `"INCOMPLETE_PRICING"` `"INSUFFICIENT_AUTH_SCOPE"` `"INTERNAL_COMMAND_ERROR"` `"INTERNAL_COMMAND_TIMEOUT"` `"INVALID_ASSEMBLY_STATUS"` `"INVALID_AUTH_EXPIRES_PARAMETER"` `"INVALID_AUTH_KEY_PARAMETER"` `"INVALID_AUTH_MAX_NUMBER_OF_FILES_PARAMETER"` `"INVALID_AUTH_MAX_SIZE_PARAMETER"` `"INVALID_AUTH_REFERER_PARAMETER"` `"INVALID_FILE_META_DATA"` `"INVALID_FORM_DATA"` `"INVALID_INPUT_ERROR"` `"INVALID_PARAMS_FIELD"` `"INVALID_SIGNATURE"` `"INVALID_STEP_NAME"` `"INVALID_TEMPLATE_FIELD"` `"INVALID_UPLOAD_HANDLE_STEP_NAME"` `"INVALID_URL_ENCODING"` `"MAX_NUMBER_OF_FILES_EXCEEDED"` `"MAX_SIZE_EXCEEDED"` `"MEGA_IMPORT_ACCESS_DENIED"` `"MEGA_IMPORT_FAILURE"` `"MEGA_IMPORT_NOT_FOUND"` `"MEGA_IMPORT_VALIDATION"` `"MEGA_STORE_ACCESS_DENIED"` `"MEGA_STORE_NOT_FOUND"` `"MEGA_STORE_VALIDATION"` `"MEGA_STORE_WRONG_REGION"` `"META_WRITE_VALIDATION"` `"MINIO_IMPORT_ACCESS_DENIED"` `"MINIO_IMPORT_FAILURE"` `"MINIO_IMPORT_NOT_FOUND"` `"MINIO_IMPORT_VALIDATION"` `"MINIO_STORE_ACCESS_DENIED"` `"MINIO_STORE_NOT_FOUND"` `"MINIO_STORE_VALIDATION"` `"MINIO_STORE_WRONG_REGION"` `"NO_AUTH_EXPIRES_PARAMETER"` `"NO_AUTH_KEY_PARAMETER"` `"NO_AUTH_PARAMETER"` `"NO_COUNTRY"` `"NO_OBJECT_AUTH_PARAMETER"` `"NO_OBJECT_PARAMS_FIELD"` `"NO_PARAMS_FIELD"` `"NO_PRICING"` `"NO_RESULT_STEP_FOUND"` `"NO_RPC_RESULT_FROM_IMAGE_RESIZER"` `"NO_SIGNATURE_FIELD"` `"NO_TEMPLATE_ID"` `"PLAN_LIMIT_EXCEEDED"` `"POSSIBLY_MALICIOUS_FILE_FOUND"` `"PRIORITY_JOB_SLOTS_NOT_FOUND"` `"PRIORITY_JOB_SLOT_STATS_ERROR"` `"PRIORITY_JOB_SLOT_STATS_INVALID_AGGREGATION"` `"PRIORITY_JOB_SLOT_STATS_INVALID_TIME"` `"PRIORITY_JOB_SLOT_STATS_MISSING_REGION"` `"RATE_LIMIT_REACHED"` `"REFERER_MISMATCH"` `"REQUEST_PREMATURE_CLOSED"` `"ROBOT_VALIDATION_BASE_ERROR"` `"S3_ACCESS_DENIED"` `"S3_IMPORT_ACCESS_DENIED"` `"S3_IMPORT_FAILURE"` `"S3_IMPORT_NOT_FOUND"` `"S3_IMPORT_VALIDATION"` `"S3_NOT_FOUND"` `"S3_STORE_ACCESS_DENIED"` `"S3_STORE_FAILURE"` `"S3_STORE_NOT_FOUND"` `"S3_STORE_URL_VERIFICATION_FAILURE"` `"S3_STORE_VALIDATION"` `"S3_STORE_WRONG_REGION"` `"S3_WRONG_REGION"` `"SCRIPT_RUN_VALIDATION"` `"SERVER_403"` `"SERVER_404"` `"SERVER_500"` `"SFTP_IMPORT_ACCESS_DENIED"` `"SFTP_IMPORT_FAILURE"` `"SFTP_IMPORT_NOT_FOUND"` `"SFTP_IMPORT_VALIDATION"` `"SFTP_STORE_VALIDATION"` `"SIGNATURE_REUSE_DETECTED"` `"SPEECH_TRANSCRIBE_VALIDATION"` `"STORAGE_GRANT_NOT_CREATED"` `"SUPABASE_IMPORT_ACCESS_DENIED"` `"SUPABASE_IMPORT_FAILURE"` `"SUPABASE_IMPORT_NOT_FOUND"` `"SUPABASE_IMPORT_VALIDATION"` `"SUPABASE_STORE_ACCESS_DENIED"` `"SUPABASE_STORE_NOT_FOUND"` `"SUPABASE_STORE_VALIDATION"` `"SUPABASE_STORE_WRONG_REGION"` `"SWIFT_IMPORT_ACCESS_DENIED"` `"SWIFT_IMPORT_FAILURE"` `"SWIFT_IMPORT_NOT_FOUND"` `"SWIFT_IMPORT_VALIDATION"` `"SWIFT_STORE_ACCESS_DENIED"` `"SWIFT_STORE_NOT_FOUND"` `"SWIFT_STORE_VALIDATION"` `"SWIFT_STORE_WRONG_REGION"` `"TEMPLATE_CREDENTIALS_INJECTION_ERROR"` `"TEMPLATE_DB_ERROR"` `"TEMPLATE_DENIES_STEPS_OVERRIDE"` `"TEMPLATE_INVALID_JSON"` `"TEMPLATE_NOT_FOUND"` `"TEXT_SPEAK_VALIDATION"` `"TEXT_TRANSLATE_VALIDATION"` `"TIGRIS_IMPORT_ACCESS_DENIED"` `"TIGRIS_IMPORT_FAILURE"` `"TIGRIS_IMPORT_NOT_FOUND"` `"TIGRIS_IMPORT_VALIDATION"` `"TIGRIS_STORE_ACCESS_DENIED"` `"TIGRIS_STORE_NOT_FOUND"` `"TIGRIS_STORE_VALIDATION"` `"TIGRIS_STORE_WRONG_REGION"` `"TMP_FILE_DOWNLOAD_ERROR"` `"TOKEN_INVALID_CREDENTIALS"` `"TRANSIENT_STORAGE_SERVICE_ERROR"` `"TRANSLOADIT_IMPORT_ACCESS_DENIED"` `"TRANSLOADIT_IMPORT_FAILURE"` `"TRANSLOADIT_IMPORT_NOT_FOUND"` `"TRANSLOADIT_IMPORT_VALIDATION"` `"TRANSLOADIT_STORE_CONFLICT"` `"TRANSLOADIT_STORE_FAILURE"` `"TRANSLOADIT_STORE_UNAVAILABLE"` `"TRANSLOADIT_STORE_VALIDATION"` `"TUS_STORE_VALIDATION"` `"USER_COMMAND_ERROR"` `"VERIFIED_EMAIL_REQUIRED"` `"VIDEO_ADAPTIVE_VALIDATION"` `"VIDEO_ARTWORK_VALIDATION"` `"VIDEO_CONCAT_INVALID_INPUT"` `"VIDEO_CONCAT_NO_OUTPUT"` `"VIDEO_CONCAT_VALIDATION"` `"VIDEO_ENCODE_INVALID_VIDEO_CODEC"` `"VIDEO_ENCODE_INVALID_WATERMARK_POSITION"` `"VIDEO_ENCODE_VALIDATION"` `"VIDEO_GENERATE_VALIDATION"` `"VIDEO_MERGE_NO_IMAGE_FOUND"` `"VIDEO_MERGE_VALIDATION"` `"VIDEO_ONDEMAND_NOT_FOUND"` `"VIDEO_ONDEMAND_VALIDATION"` `"VIDEO_SPLIT_NO_OUTPUT"` `"VIDEO_SPLIT_VALIDATION"` `"VIDEO_SUBTITLE_VALIDATION"` `"VIDEO_THUMBS_INVALID_COUNT_VALUE"` `"VIDEO_THUMBS_INVALID_FORMAT"` `"VIDEO_THUMBS_INVALID_INPUT"` `"VIDEO_THUMBS_VALIDATION"` `"VIMEO_IMPORT_ACCESS_DENIED"` `"VIMEO_IMPORT_FAILURE"` `"VIMEO_IMPORT_NOT_FOUND"` `"VIMEO_IMPORT_VALIDATION"` `"VIMEO_STORE_ACCESS_DENIED"` `"VIMEO_STORE_PROBLEM_SENDING_FILE"` `"VIMEO_STORE_VALIDATION"` `"WASABI_IMPORT_ACCESS_DENIED"` `"WASABI_IMPORT_FAILURE"` `"WASABI_IMPORT_NOT_FOUND"` `"WASABI_IMPORT_VALIDATION"` `"WASABI_STORE_ACCESS_DENIED"` `"WASABI_STORE_NOT_FOUND"` `"WASABI_STORE_VALIDATION"` `"WASABI_STORE_WRONG_REGION"` `"WORKER_JOB_ERROR"` `"YOUTUBE_STORE_PROBLEM_SENDING_FILE"` `"YOUTUBE_STORE_VALIDATION"`
`exitCode`	`number \| null` Estado de salida opcional de un comando de procesamiento que ha fallado. Los detalles de diagnóstico pueden variar; usa el código `error` para gestionar errores de forma programática.
`exitSignal`	`null \| string` Señal opcional que terminó un comando de procesamiento. Los detalles de diagnóstico pueden variar; usa el código `error` para gestionar errores de forma programática.
`file`	`string`
`headers`	`object` Esquema de propiedades adicionales `cualquier valor`
`is_private_address`	`boolean`
`name`	`string`
`numRetries`	`number`
`ok`	`null`
`playwright_error_code`	`string`
`reason`	`null \| string \| number \| boolean \| Array<cualquier valor> \| object` Detalles de diagnóstico opcionales. No asumas que este valor es una cadena ni lo muestres directamente; usa `message` para el texto legible por humanos. Los detalles de diagnóstico pueden variar; usa el código `error` para el manejo programático de errores. 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`
`response_code`	`number \| null`
`retries`	`number`
`retryable`	`boolean`
`stderr`	`string` Salida de diagnóstico opcional de un comando de procesamiento para investigar problemas. Los detalles de diagnóstico pueden variar; usa el código `error` para gestionar errores de forma programática.
`stdout`	`string` Salida estándar opcional de un comando de procesamiento para investigar problemas. Los detalles de diagnóstico pueden variar; usa el código `error` para gestionar errores de forma programática.
`url`	`string`
`url_host`	`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: "INVALID_PARAMS_FIELD"

Se proporcionó un campo params incorrecto, contiene json no válido.

La respuesta puede contener campos adicionales.

Campo	Tipo y descripción
`error` obligatorio	`string` (siempre: "INVALID_PARAMS_FIELD")
`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.

Para obtener más información sobre la respuesta, consulta nuestra documentación sobre la Respuesta de Assembly Status.

Crear una nueva Assembly

Ejemplo de solicitud

Autenticación

Parámetros opcionales de consulta de la respuesta

Campos de formulario multipart

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`