Códigos de respuesta

A continuación se enumeran los códigos de respuesta que devuelve Transloadit y que puedes usar para gestionar errores.

Una Assembly está en ejecución si ok es ASSEMBLY_UPLOADING o ASSEMBLY_EXECUTING. Todos los demás estados indican que la Assembly ha finalizado. Si finalizó con un error, se establecerá la propiedad error. A continuación, encontrarás más detalles sobre los códigos ok y error.

Códigos OK

Los códigos OK siempre se devuelven mediante la clave ok, de esta forma: { ok: "{OK_CODE}" }.

ASSEMBLY_CANCELED: La Assembly fue cancelada.
ASSEMBLY_COMPLETED: La Assembly finalizó correctamente.
ASSEMBLY_EXECUTING: La Assembly se está ejecutando actualmente.
ASSEMBLY_NOTIFICATION_REPLAYED: La Assembly Notification fue reenviada.
ASSEMBLY_REPLAYING: La Assembly se está reejecutando.
ASSEMBLY_UPLOADING: La Assembly todavía se está subiendo.
REQUEST_ABORTED: La conexión de subida se cerró o agotó el tiempo de espera antes de recibir todos los datos.

Códigos de error

Los códigos de error siempre se devuelven mediante la clave error, de esta forma: { error: "{ERROR_CODE}" }.

ACTIVE_ASSEMBLIES_FETCHED: Cantidad de Assemblies activas obtenidas.
ADMIN_PERMISSIONS_REQUIRED: Necesitas permisos de administrador para hacer esto.
ASSEMBLIES_UPDATED: Las Assemblies se actualizaron.
ASSEMBLY_ACCOUNT_MISMATCH: No tienes permiso para acceder a esta Assembly porque no te pertenece.
ASSEMBLY_CANNOT_BE_REPLAYED: La Assembly no se puede reejecutar.
ASSEMBLY_COULD_NOT_BE_CREATED: No se pudo crear la Assembly.
ASSEMBLY_CRASHED: El proceso que gestionaba esta Assembly falló y no pudo restaurarse.
ASSEMBLY_DISALLOWED_ROBOTS_USED: Tu Assembly usa uno o más Robots no permitidos.
ASSEMBLY_EMPTY_STEPS: El parámetro {steps: …} de tu Assembly está vacío.
ASSEMBLY_EXECUTION_PROGRESS_NOT_ENABLED: No se habilitó la obtención del progreso de ejecución para esta Assembly.
ASSEMBLY_EXPIRED: La Assembly venció.
ASSEMBLY_FILE_ACCEPTED: La Assembly aceptó el archivo agregado.
ASSEMBLY_FILE_NOT_RESERVED: Debe reservarse un lugar para este archivo antes de agregarlo.
ASSEMBLY_FILE_RESERVED: La Assembly reservó espacio para este archivo.
ASSEMBLY_INFINITE: Tu Assembly parece ser infinita; los parámetros "use" forman un bucle.
ASSEMBLY_INVALID_NOTIFY_URL: La Assembly tenía un notify_url con formato incorrecto. Deben ser cadenas.
ASSEMBLY_INVALID_NUM_EXPECTED_UPLOAD_FILES_PARAM: El valor de tu parámetro 'num_expected_upload_files' no es válido. Debe ser un número mayor o igual que cero.
ASSEMBLY_INVALID_STEPS: El valor de {steps: …} de tu Assembly no es un objeto.
ASSEMBLY_JOB_ENQUEUE_ERROR: Hubo un problema al poner en cola un Job para tu Assembly. Comunícate con soporte.
ASSEMBLY_LIST_ERROR: Parámetros incorrectos
ASSEMBLY_MEMORY_LIMIT_EXCEEDED: Se superó el límite de memoria de 8 MB de la Assembly. Intenta importar menos archivos o subir un archivo zip que contenga menos archivos.
ASSEMBLY_NOTIFICATIONS_LIST_ERROR: No se pudieron enumerar las Assembly Notifications.
ASSEMBLY_NOTIFICATION_LIST_ERROR: Parámetros incorrectos
ASSEMBLY_NOTIFICATION_NOT_PERSISTED: Hubo un problema al guardar la Assembly Notification. Comunícate con soporte.
ASSEMBLY_NOTIFICATION_NOT_REPLAYED: No se pudo reenviar la Assembly Notification.
ASSEMBLY_NOT_CAPABLE: Esta Assembly no puede gestionar el endpoint solicitado.
ASSEMBLY_NOT_FINISHED: La Assembly aún no ha finalizado y, por lo tanto, todavía no se puede reejecutar.
ASSEMBLY_NOT_FOUND: La Assembly que solicitaste falló o no existe.
ASSEMBLY_NOT_REPLAYED: No se pudo reejecutar la Assembly
ASSEMBLY_NO_CHARGEABLE_STEP: Una Assembly debe tener al menos una transcodificación o un Step.
ASSEMBLY_NO_NOTIFY_URL: La Assembly no tenía configurado ningún notify_url.
ASSEMBLY_NO_STEPS: Tu Assembly no incluye un parámetro {steps: …}.
ASSEMBLY_PROGRESS_UPDATED: Se actualizó el progreso de subida de la Assembly.
ASSEMBLY_ROBOT_MISSING: Esta Assembly debe usar Robots específicos según el contrato.
ASSEMBLY_SATURATED: Esta Assembly ya recibió todas las subidas de archivos esperadas.
ASSEMBLY_STATS_INVALID_TIME: El tiempo de inicio falta o es incorrecto
ASSEMBLY_STATS_MISSING_REGION: Debes proporcionar una región específica o "all"
ASSEMBLY_STATUS_FETCHING_RATE_LIMIT_REACHED: Estás obteniendo el estado de la misma Assembly con demasiada frecuencia. Reduce la frecuencia.
ASSEMBLY_STATUS_NOT_FOUND: No se pudo encontrar el estado de la Assembly que solicitaste.
ASSEMBLY_STATUS_PARSE_ERROR: Hubo un problema al analizar el JSON de estado de la Assembly.
ASSEMBLY_STEP_INVALID: El valor de uno de tus parámetros {steps: …} no es un objeto.
ASSEMBLY_STEP_INVALID_ROBOT: Uno de los parámetros de tus Steps incluye un valor {robot: …} que no es una cadena.
ASSEMBLY_STEP_INVALID_USE: Uno de los parámetros de tus Steps incluye un valor {use: …} que no es un arreglo, o los elementos del arreglo "use" no son cadenas ni objetos. Si son objetos, deben contener una propiedad "name".
ASSEMBLY_STEP_NO_ROBOT: Uno de los parámetros de tus Steps no incluía una clave {robot: …}.
ASSEMBLY_STEP_UNKNOWN_ROBOT: Uno de los parámetros de tus Steps hace referencia a un {robot: …} desconocido.
ASSEMBLY_STEP_UNKNOWN_USE: Uno de los parámetros de tus Steps hace referencia a un valor {use: …} desconocido.
ASSEMBLY_URL_TRANSFORM_MISSING: Esta Assembly debe usar la función UrlTransform según el contrato.
AUTH_EXPIRED: El parámetro de vencimiento de autenticación proporcionado corresponde a una fecha pasada.
AUTH_KEYS_FOUND: Tus Auth Keys se encontraron correctamente.
AUTH_KEYS_NOT_FOUND: No se pudieron encontrar tus Auth Keys.
AUTH_KEY_CREATED: Tu Auth Key se creó correctamente.
AUTH_KEY_DELETED: Tu Auth Key se eliminó correctamente.
AUTH_KEY_NOT_CREATED: No se pudo crear tu Auth Key.
AUTH_KEY_NOT_DELETED: No se pudo eliminar tu Auth Key.
AUTH_KEY_NOT_UPDATED: No se pudo actualizar tu Auth Key.
AUTH_KEY_SCOPES_FOUND: Los ámbitos de la Auth Key se encontraron correctamente.
AUTH_KEY_SCOPES_NOT_FOUND: No se pudieron encontrar los ámbitos de la Auth Key.
AUTH_KEY_UPDATED: Tu Auth Key se actualizó correctamente.
AUTH_SECRET_NOT_RETRIEVED: No se pudo mostrar tu Auth Secret.
AUTH_SECRET_RETRIEVED: Se pudo obtener tu Auth Secret.
BAD_PRICING: Hay un problema con el registro de precios asociado a tu Workspace. Comunícate con soporte.
BILL_LIMIT_EXCEEDED: Este mes se superó el límite de facturación configurado para este Workspace.
CANNOT_ACCEPT_NEW_ASSEMBLIES: El cargador no acepta Assemblies nuevas.
CANNOT_FETCH_ACTIVE_ASSEMBLIES: Se produjo un error al obtener la cantidad de Assemblies activas.
CDN_REQUIRED: Recomendamos usar URL Transform únicamente junto con una CDN para almacenar los resultados en caché. De lo contrario, cada acceso se transcodifica, lo que puede aumentar rápidamente las facturas de las páginas populares. Por eso, debes configurar (o hacer que tu CDN configure) el parámetro de consulta o la clave de encabezado 'cdn' con el valor 'required'.
COMPANION_BASIC_AUTH_UNSET: No se pueden validar las credenciales de Basic Auth
COMPANION_CREDENTIALS_REQUEST_INVALID: La solicitud de credenciales de Companion contiene datos no válidos
COMPANION_OSS_SUPPORT_PING_REQUEST_INVALID: La solicitud de ping del soporte de Companion OSS contiene datos no válidos
DO_NOT_REUSE_ASSEMBLY_IDS: No reutilices Assembly IDs.
FILE_DOWNLOAD_ERROR: Transloadit no pudo descargar un archivo externo.
FILE_META_DATA_ERROR: Hubo un problema al extraer la información de metadatos de tu archivo.
FILE_SERVE_NO_RESULT: El Step /file/serve no tiene ningún resultado que entregar. Es posible que tus Instructions no sean compatibles con el tipo de archivo de entrada.
GET_ACCOUNT_DB_ERROR: No se pudo obtener el Workspace debido a un error de la base de datos.
GET_ACCOUNT_UNKNOWN_AUTH_KEY: No se pudo obtener el Workspace porque esta Auth Key es desconocida.
GRAFANA_WEBHOOK_ERROR: Error del webhook de Grafana
GRAFANA_WEBHOOK_WRITE_ERROR: Error de escritura del webhook de Grafana
IMPORT_FILE_ERROR: Transloadit no pudo importar un archivo.
INCOMPLETE_PRICING: Hay un problema con el registro de precios asociado a tu Workspace. Comunícate con soporte.
INSUFFICIENT_AUTH_SCOPE: La Auth Key que usaste para la operación no tiene el ámbito requerido.
INTERNAL_COMMAND_ERROR: Uno de nuestros comandos informó un error.
INTERNAL_COMMAND_TIMEOUT: Uno de nuestros comandos agotó el tiempo de espera.
INVALID_ASSEMBLY_STATUS: Este estado de Assembly no es válido.
INVALID_AUTH_EXPIRES_PARAMETER: Se proporcionó un parámetro de vencimiento de autenticación no válido; no pudimos analizarlo.
INVALID_AUTH_KEY_PARAMETER: Se proporcionó un parámetro de Auth Key no válido; el valor no es una cadena.
INVALID_AUTH_MAX_SIZE_PARAMETER: Se proporcionó un parámetro de referente de autenticación no válido; no pudimos analizarlo.
INVALID_AUTH_REFERER_PARAMETER: Se proporcionó un parámetro de referente de autenticación no válido; no pudimos analizarlo.
INVALID_FILE_META_DATA: No pudimos analizar los metadatos del archivo #file#.
INVALID_FORM_DATA: El formulario contenía datos incorrectos que no pueden analizarse.
INVALID_INPUT_ERROR: No se pudieron procesar los archivos porque este Robot no admite el formato proporcionado.
INVALID_PARAMS_FIELD: Se proporcionó un campo params incorrecto; contiene JSON no válido.
INVALID_SIGNATURE: La firma proporcionada no coincide con la nuestra. ¿Es posible que tu Auth Key exija usar sha384 en lugar de sha1?
INVALID_STEP_NAME: No debes asignar el nombre ":original" a un Step que no use el Robot /upload/handle. Esto provocará una creación incorrecta de Jobs, como Jobs duplicados o Assemblies infinitas.
INVALID_TEMPLATE_FIELD: Se proporcionó un campo de Template incorrecto; contiene JSON no válido.
INVALID_UPLOAD_HANDLE_STEP_NAME: Al usar el Robot /upload/handle, el nombre de su Step debe ser ":original".
MAX_SIZE_EXCEEDED: El archivo subido superó el límite de tamaño de archivo.
NO_AUTH_EXPIRES_PARAMETER: No se proporcionó ningún parámetro de vencimiento de autenticación.
NO_AUTH_KEY_PARAMETER: No se proporcionó ningún parámetro de Auth Key.
NO_AUTH_PARAMETER: No se proporcionó ningún parámetro de autenticación.
NO_COUNTRY: Tu Workspace no tiene ningún registro de país asociado. Comunícate con soporte o actualiza la información de tu Workspace.
NO_OBJECT_AUTH_PARAMETER: Se proporcionó un parámetro de autenticación incorrecto; no es un objeto.
NO_OBJECT_PARAMS_FIELD: Se proporcionó un campo params incorrecto; no es un objeto.
NO_PARAMS_FIELD: No se proporcionó ningún campo params.
NO_PRICING: Tu Workspace no tiene ningún registro de precios asociado. Comunícate con soporte.
NO_RESULT_STEP_FOUND: No se definió ningún Step de resultado o el definido no es válido; este es obligatorio para las Assemblies de URL Transform.
NO_RPC_RESULT_FROM_IMAGE_RESIZER: No hay ningún resultado rpc de image-resizer
NO_SIGNATURE_FIELD: No se proporcionó ningún campo de firma.
NO_TEMPLATE_ID: Este Workspace exige que se proporcione un Template ID, pero no se proporcionó ninguno.
PLAN_LIMIT_EXCEEDED: Superaste el límite de uso de tu plan de Transloadit. Mejora tu plan para que deje de aparecer este mensaje de error o comunícate con soporte.
POSSIBLY_MALICIOUS_FILE_FOUND: Es posible que uno de tus archivos sea malicioso y no se puede procesar.
PRIORITY_JOB_SLOTS_FOUND: Tus cupos prioritarios se encontraron correctamente.
PRIORITY_JOB_SLOTS_NOT_FOUND: No se pudieron encontrar tus cupos prioritarios.
QUEUES_LIST_ERROR: Se produjo un error al obtener las estadísticas de la cola
QUEUE_ACTORS_ERROR: No se pudieron obtener ni restablecer los actores de la cola
RATE_LIMIT_REACHED: Se alcanzó el límite de solicitudes
REFERER_MISMATCH: Esta solicitud proviene de una ubicación no permitida.
REQUEST_PREMATURE_CLOSED: La solicitud original se cerró prematuramente.
SERVER_401: Se requiere autorización
SERVER_403: Prohibido
SERVER_404: Método o URL desconocidos
SERVER_500: Error inesperado
SIGNATURE_REUSE_DETECTED: La solicitud se rechazó por motivos de seguridad. Si crees que se trata de un error, comunícate con soporte.
SYNC_ERROR: No se pudo sincronizar la base de datos
TEMPLATE_CREATED: Tu Template se creó correctamente.
TEMPLATE_CREDENTIALS_CREATED: Tus credenciales de Template se crearon correctamente.
TEMPLATE_CREDENTIALS_DELETED: Tus credenciales de Template se eliminaron correctamente.
TEMPLATE_CREDENTIALS_FOUND: Tus credenciales de Template se encontraron correctamente.
TEMPLATE_CREDENTIALS_INJECTION_ERROR: No se pudieron insertar tus credenciales de Template.
TEMPLATE_CREDENTIALS_NOT_CREATED: No se pudieron crear tus credenciales de Template.
TEMPLATE_CREDENTIALS_NOT_DELETED: No se pudieron eliminar tus credenciales de Template.
TEMPLATE_CREDENTIALS_NOT_FOUND: No se pudieron encontrar tus credenciales de Template.
TEMPLATE_CREDENTIALS_NOT_READ: No se pudieron leer tus credenciales de Template.
TEMPLATE_CREDENTIALS_NOT_UPDATED: No se pudieron actualizar tus credenciales de Template.
TEMPLATE_CREDENTIALS_READ: Tus credenciales de Template se leyeron correctamente.
TEMPLATE_CREDENTIALS_TYPES_FOUND: Los tipos de credenciales de Template se encontraron correctamente.
TEMPLATE_CREDENTIALS_TYPES_NOT_FOUND: No se pudieron encontrar los tipos de credenciales de Template.
TEMPLATE_CREDENTIALS_UPDATED: Tus credenciales de Template se actualizaron correctamente.
TEMPLATE_DB_ERROR: No se pudo obtener el Template de esta solicitud debido a un error de la base de datos.
TEMPLATE_DELETED: Tu Template se eliminó correctamente.
TEMPLATE_DENIES_STEPS_OVERRIDE: Este Template tenía la opción allow_steps_override establecida en false, por lo que los clientes no tienen permiso para alterar sus Steps.
TEMPLATE_FOUND: Tu Template se encontró correctamente.
TEMPLATE_INVALID_JSON: Tu Template contenía JSON no válido.
TEMPLATE_LIST_ERROR: Parámetros incorrectos
TEMPLATE_NOT_FOUND: No se encontró ningún Template para el template_id y el Workspace proporcionados.
TEMPLATE_UPDATED: Tu Template se actualizó correctamente.
TEMPLATE_VALIDATION_ERROR: Tu Template no superó la validación.
TMP_FILE_DOWNLOAD_ERROR: Transloadit no pudo descargar un archivo desde nuestra ubicación temporal.
USER_COMMAND_ERROR: Un archivo o ajuste no válido provocó el fallo de un comando.
VERIFIED_EMAIL_REQUIRED: Primero debes verificar tu dirección de email antes de poder hacer esto.
WORKER_JOB_ERROR: Transloadit no pudo procesar esta Assembly.