Cómo aceptar subidas grandes pese a una conexión interrumpida

Una subida grande no es una solicitud que falla ocasionalmente. Es una transferencia que se interrumpirá, y la única decisión real es si una interrupción le cuesta al usuario los bytes restantes o todos ellos. Todo lo demás en el diseño se deriva de esa elección.

Lo más importante

• Las subidas que exceden la cantidad declarada se descartan silenciosamente, por lo que un desfase de uno en esa cifra provoca la pérdida de archivos sin generar un error.
• Los archivos pueden tener hasta 200 GB, pero la Assembly vence de todos modos ocho horas después de su creación.

POST /assemblies HTTP/1.1
Host: api2.transloadit.com
Content-Type: multipart/form-data; boundary=---xyz

-----xyz
Content-Disposition: form-data; name="params"

{"auth":{"key":"YOUR_KEY"},
 "template_id":"YOUR_TEMPLATE_ID"}
-----xyz
Content-Disposition: form-data;
  name="num_expected_upload_files"

2
-----xyz--

HEAD /resumable/files/136058f2ef4d HTTP/1.1
Host: api2-freja.transloadit.com
Tus-Resumable: 1.0.0

HTTP/1.1 204 No Content
Upload-Offset: 3000
Upload-Length: 10000

PATCH /resumable/files/136058f2ef4d HTTP/1.1
Host: api2-freja.transloadit.com
Tus-Resumable: 1.0.0
Upload-Offset: 3000
Content-Length: 7000
Content-Type: application/offset+octet-stream

const uppy = new Uppy().use(Transloadit, {
  waitForEncoding: true,
  assemblyOptions: async () => {
    // Your back end signs with the Auth Secret
    const res = await fetch('/api/tl-signature')
    const { params, signature } = await res.json()
    return { params, signature }
  },
})

Detalles técnicos que conviene conocer

• La Assembly se crea mediante una solicitud POST multipart que incluye params y num_expected_upload_files, pero no contenido de archivos, y la respuesta incluye tus_url, expected_tus_uploads, started_tus_uploads y finished_tus_uploads.
• Una Assembly permanece en el estado ASSEMBLY_UPLOADING hasta que finalizan todas las subidas declaradas mediante el protocolo tus, incluso cuando algunos de los archivos que ya recibió se hayan procesado.
• Cada subida mediante el protocolo tus comienza con una solicitud POST a tus_url que incluye assembly_url, filename y fieldname como metadatos, y el servidor responde con la URL de subida en el encabezado Location.
• La reanudación consiste en una solicitud HEAD a esa URL de subida, que informa la cantidad de bytes recibidos en el encabezado Upload-Offset, seguida de una solicitud PATCH que envía el resto exactamente desde ese desplazamiento.
• Los metadatos adicionales enviados con una subida se convierten en una Assembly Variable en file.user_meta, que corresponde a cada archivo, a diferencia de fields, que se comparte entre todos los archivos de la misma Assembly.
• La subida está limitada a ocho horas y el procesamiento a otras ocho, con un máximo de dieciséis horas desde la creación; después, la Assembly devuelve ASSEMBLY_EXPIRED.

Un enfoque práctico

Cuándo resulta útil Transloadit

Usa Uppy con el plugin de Transloadit en el navegador, o cualquier cliente tus en otros entornos, y deja que /upload/handle reciba los archivos. Primero crea la Assembly con num_expected_upload_files y luego envía cada archivo a la tus_url devuelta en el Assembly Status.

Límite de la arquitectura

La capacidad de reanudación recupera una transferencia interrumpida, no una olvidada. Las subidas deben finalizar dentro de las ocho horas posteriores a la creación de la Assembly, y el procesamiento dispone de otras ocho horas, con un límite total de dieciséis horas desde la creación. Después, la Assembly devuelve ASSEMBLY_EXPIRED y los bytes ya recibidos dejan de ser utilizables.