Transloadit
Precios
  • Subida de archivos
  • Importación de archivos
  • Procesamiento por lotes (English)
  • Encoding de video
  • Encoding de audio
  • Procesamiento de imágenes
  • Procesamiento de documentos
  • Inteligencia artificial
  • Filtrado y seguridad de archivos
  • Catalogación de medios
  • Compresión de archivos
  • Evaluación de código
  • Exportación de archivos
  • Smart CDN
  • Ver todos los servicios
  • Explora integraciones (English)
  • Explora demos en vivo (English)
  • Uppy
  • TransloaditKit
  • Android SDK
  • Node.js SDK
  • Python SDK
  • Ruby SDK
  • Go SDK
  • Java SDK
  • PHP SDK
  • Zapier
  • MCP Server
  • Transloadit CLI
  • Terraform
  • Conceptos esenciales
  • Prácticas recomendadas
  • FAQ
  • Robots
  • Endpoints de la API
  • Formatos
  • Crea tu primera app
  • Acerca de Transloadit
  • Comparaciones
  • Código abierto
  • Testimonios
  • Empleos (English)
  • Seguridad
  • Entradas
  • Actualidad para desarrolladores (English)
  • Consejos para desarrolladores
  • Prensa (English)
  • Investigación (English)
  • Casos de éxito
  • Soluciones
  • Guías
  • Glosario (English)
  • Legal (English)
  • Herramientas
  • Cómo ayudamos a Coursera a llevar educación a millones de personas en todo el mundo
  • Soporte de Transloadit
  • Soporte para código abierto
  • Acuerdo de nivel de servicio (English)
Conceptos esencialesRobotsFAQEndpoints de la APIFormatosPrácticas recomendadas
Temas
  • Endpoints
  • Códigos de respuesta
  • Autenticación
  • Webhooks
  • Metadatos
  • Seguridad de la API
  • Limitación de tasa
  • Colas
  • Subidas reanudables
Autenticación
  • Crear un token Bearer
  • Crear un nuevo Auth Key
  • Consultar la lista de Auth Keys
  • Obtener los ámbitos de la Auth Key
  • Editar un Auth Key
  • Eliminar un Auth Key
  • Consultar el secreto de un Auth Key
Assemblies
  • Crear una nueva Assembly
  • Recuperar un Assembly Status
  • Crear una Assembly con un ID proporcionado
  • Transmitir en vivo los cambios de una Assembly
  • Cancelar una Assembly en ejecución
  • Reejecutar una Assembly
  • Recuperar la lista de Assemblies
  • Respuesta de Assembly Status
  • Consultar estadísticas de Assemblies
Webhooks
  • Consultar Assembly Notifications
  • Reenviar una Assembly Notification
Facturación
  • Recuperar la factura de un mes
Colas
  • Recuperar los cupos prioritarios actualmente en uso
  • Consultar estadísticas de cupos prioritarios
Subidas reanudables
  • Descubrir las capacidades del protocolo tus
  • Crear una subida tus
  • Consultar el offset de una subida tus
  • Subir bytes de un archivo tus
  • Finalizar una subida tus
  • Descargar una subida tus
Credenciales de Template
  • Crear una nueva credencial de Template
  • Recuperar una credencial de Template
  • Editar una credencial de Template
  • Eliminar una credencial de Template
  • Recuperar la lista de credenciales de Template
  • Consultar los tipos de credencial de Template
Templates
  • Crear un nuevo Template
  • Recuperar un Template
  • Editar un Template
  • Eliminar un Template
  • Recuperar la lista de Templates
Gestión de activos digitales
  • Mover o renombrar un activo DAM
  • Eliminar un activo DAM
  • Mover activos DAM en bloque
  • Eliminar activos DAM en bloque

Crear una Assembly con un ID proporcionado

Crea una Assembly con un Assembly ID nuevo elegido por quien realiza la solicitud.

PUThttps://api2.transloadit.com/assemblies/{assemblyId}

Crea una Assembly con un ID nuevo proporcionado por quien realiza la llamada. Esto no reemplaza una Assembly existente. Nunca debes reutilizar el ID de una Assembly, ni siquiera después de que la Assembly haya caducado o se haya eliminado. Un conflicto con un ID activo puede devolver ASSEMBLY_COULD_NOT_BE_CREATED; un uso previo registrado puede devolver DO_NOT_REUSE_ASSEMBLY_IDS. Estas comprobaciones no son una garantía permanente de deduplicación. Este endpoint no es un mecanismo de reintento idempotente.

Flujo de trabajo habitual:

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

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

Usa Reejecutar una Assembly para volver a intentar el procesamiento de entradas recuperables como una nueva Assembly, o Cancelar una Assembly para detener una existente.

Ejemplo de solicitud

La siguiente solicitud usa openssl para generar un ID de Assembly nuevo e impredecible. Genera un ID nuevo para cada solicitud; nunca reutilices uno.

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 sección de 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 a TRANSLOADIT_KEY y TRANSLOADIT_SECRET los valores de tu Auth Key y tu Auth Secret. Mantén en secreto ambas credenciales y el token resultante; nunca ejecutes esta configuración en código del navegador.

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

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.

ASSEMBLY_ID="$(openssl rand -hex 16)" || exit 1

curl --fail-with-body -sS --request PUT \
  --url "https://api2.transloadit.com/assemblies/${ASSEMBLY_ID:?Set ASSEMBLY_ID}" \
  --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 acepta la Assembly; no significa que el procesamiento haya terminado. 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 casos constituye un procesamiento correcto.

Cuando ok sea ASSEMBLY_COMPLETED, la salida de este ejemplo estará en results.resize. Una respuesta de finalización 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 de salida temporales 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 de ruta

  • assemblyId (segmento de ruta), obligatorio. patrón: ^[a-z0-9]{32}$

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.

CampoTipo 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 al menos tu Auth Key de Transloadit en la propiedad key.

Si habilitas 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 una propiedad nonce generada aleatoriamente, un valor único por solicitud que hace que las Signatures generadas de forma independiente sean distintas, facilita la depuración y evita la reutilización accidental de Signatures. 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 reintentos en tu aplicación cuando sea necesario. No reutilices params firmados entre endpoints. Las consultas de Templates, los listados de Auth Keys, los listados de credenciales de Templates y las consultas de facturación rechazan, con SIGNATURE_REUSE_DETECTED, las Signatures que ya se hayan registrado para un endpoint diferente o que se hayan usado para crear una Assembly. Genera nuevos params firmados para cada solicitud.

{
  // …
  "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". Especifica esta clave para asegurarte de que las cargas solo procedan de tu dominio.

Las cargas sin referer siempre pasarán esta comprobación (ya que el referer está desactivado en algunos navegadores), 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⁠.

La propiedad max_size limita el tamaño total previsto de carga 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 Assembly más sus cargas reanudables. Superar el límite 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 la 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, utiliza 🤖/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 evitar 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

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.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.auth.referer
string

Expresión regular que se compara con el Referer HTTP para restringir el origen de la subida

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.

CampoTipo 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.

CampoTipo 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

CampoTipo y descripción
params.auth
object

Metadatos de autenticación y restricciones de carga para una solicitud de Assembly con autenticación 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". Especifique esta clave para asegurarse de que las cargas solo provengan de su dominio.

Las cargas sin referer siempre pasarán la comprobación (ya que el referer está desactivado en algunos navegadores), lo que hace que esto sea útil solo en unos pocos casos de uso. Para obtener más información sobre las expresiones regulares, consulte la documentación de RegExp de Mozilla⁠.

La propiedad max_size limita el tamaño total previsto de carga de la Assembly en bytes, como 1048576 (1 MB), en lugar de limitar cada archivo por separado. Esto incluye el cuerpo de la solicitud multiparte, 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íe en este límite para rechazar todas las transferencias que superen el tamaño permitido 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 desea ignorar los archivos que superen un tamaño determinado, pero procesar todos los demás, utilice 🤖/file/filter.

La propiedad max_number_of_files se puede usar para establecer un número máximo de archivos que puede tener una carga, como 100. Especifique esta propiedad 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.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.auth.referer
string

Expresión regular que se compara con el Referer HTTP para restringir el origen de la subida

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

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

CampoTipo y descripción
account_id
null | string
account_name
null | string
account_slug
null | string
api_auth_key_id
null | string
assemblyId
string
assembly_id
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.

CampoTipo 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
notify_start
null | string
notify_status
null | string
notify_url
null | string
num_input_files
number
params
null | string
parent_assembly_status
cualquier valor | null

Puede aplicarse cualquiera de los esquemas siguientes:

cualquier valor
cualquier valor
null
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.

template
null | string
template_id
null | string
template_name
null | string
transloadit_client
null | string
tus_uploads
Array<object>
Esquema de los elementos del array
object

tus_uploads[]: La respuesta puede contener campos adicionales.

CampoTipo 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
CampoTipo y descripción
uploads[].as
string | Array<string> | null

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

uploads[].cost
number | null
uploads[].exec_time
number
uploads[].from_batch_import
boolean
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[].ssl_url
null | string
uploads[].tus_upload_url
null | string
uploads[].user_meta
object

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

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.

CampoTipo y descripción
uploads[].basename

obligatorio

null | string

El nombre del archivo sin la extensión.

uploads[].ext

obligatorio

string

La extensión del archivo.

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 con metadatos adicionales extraídos del archivo, como se muestra a continuación.

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 en nuestros servidores caducan después de unas horas; exporta los archivos a un sistema de 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 asset_id devuelto para las operaciones de DAM y el path devuelto para /transloadit/import. Actualiza la ruta guardada al mover el recurso o cambiarle el nombre; ni una URL temporal ni el id del archivo de procesamiento son una referencia de almacenamiento duradera.

Variante 2: object
object

uploads[]: La respuesta puede contener campos adicionales.

CampoTipo y descripción
uploads[].basename
null | string

El nombre del archivo sin la extensión.

uploads[].ext
string

La extensión del archivo.

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 con metadatos adicionales extraídos del archivo, como se muestra a continuación.

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 en nuestros servidores caducan después de unas horas; exporta los archivos a un sistema de 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 asset_id devuelto para las operaciones de DAM y el path devuelto para /transloadit/import. Actualiza la ruta guardada al mover el recurso o cambiarle el nombre; ni una URL temporal ni el id del archivo de procesamiento son una referencia de almacenamiento duradera.

uppyserver_url
null | string
usage_tags
string
virusname
string
warnings
Array<object>
Esquema de los elementos del array
object

warnings[]: La respuesta puede contener campos adicionales.

CampoTipo 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.

CampoTipo y descripción
error
nunca

Indica un estado de error. Esta clave solo está presente si la Assembly falló.

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: "ASSEMBLY_CANCELED" | "ASSEMBLY_COMPLETED" | "ASSEMBLY_EXECUTING" | "ASSEMBLY_REPLAYING" | "ASSEMBLY_UPLOADING" | "REQUEST_ABORTED"

La respuesta puede contener campos adicionales.

CampoTipo y descripción
error
nunca

Indica un estado de error. Esta clave solo está presente si la Assembly falló.

Este valor está prohibido.

ok

obligatorio

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

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.

propiedades obligatorias: error

La respuesta puede contener campos adicionales.

CampoTipo 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
string
Array<string | number>
Array<string | number>
Esquema de los elementos del array
string | number
error

obligatorio

"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" | "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"

Indica un estado de error. Esta clave solo está presente si la Assembly falló.

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
string

Explicación opcional del fallo. Los detalles de diagnóstico pueden variar; usa el código error para gestionar errores de forma programática.

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.

CampoTipo 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
null
string
string
number
number
boolean
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.

CampoTipo 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.

Página anterior ← Recuperar un Assembly StatusPágina siguiente Transmitir en vivo los cambios de una Assembly →
Contactar a soporte⁠

TransloaditVerificando el estado…

Producto

  • Servicios
  • Precios
  • Demos EN (English)
  • Herramientas
  • Seguridad
  • Soporte

Empresa

  • Acerca de Transloadit/Prensa EN (English)
  • Blog/Empleos EN (English)
  • Comparaciones/Matriz de cumplimiento EN (English)
  • Investigación EN (English)
  • Código abierto
  • Soluciones

Documentación

  • Primeros pasos
  • Transcodificación
  • FAQ
  • Endpoints de la API
  • Guías/Consejos para desarrolladores
  • Formatos compatibles

Más

  • Estado de la plataforma⁠
  • Foro de la comunidad⁠
  • StackOverflow⁠
  • Uppy EN (English)
  • tus⁠

© 2009–2026 Transloadit-II GmbH

Privacidad EN (English)Términos EN (English)Aviso legal EN (English)
EnglishDeutschEspañol