Transloadit

Subir bytes de un archivo tus

Añade bytes sin procesar al offset indicado de una subida reanudable.

PATCH{UPLOAD_URL}

Esto envía file (cuatro bytes) a una nueva carga reservada para cuatro bytes, como se muestra en Crear una carga tus. Para reanudar una transferencia, primero obtén el desplazamiento del servidor y envía solo los bytes restantes con ese desplazamiento. No vuelvas a enviar el archivo completo con un desplazamiento distinto de cero.

Omite Upload-Length en una carga de tamaño fijo. Úsalo solo cuando la carga se haya creado con Upload-Defer-Length: 1 y aún no se haya declarado la longitud total. El valor declara la longitud total del archivo en bytes, no el tamaño de este fragmento PATCH. Una vez declarada la longitud total, omite Upload-Length en las solicitudes PATCH posteriores. Si lo incluyes para una carga sin finalizar cuya longitud ya se conoce, se devuelve HTTP 400.

Ejemplo de solicitud

Asigna a UPLOAD_URL la URL completa de Location devuelta al crear la carga tus. Mantén esta URL en secreto.

curl --fail-with-body -sS --request PATCH --include \
  --url "${UPLOAD_URL:?Set UPLOAD_URL}" \
  --header 'upload-offset: 0' \
  --header 'content-type: application/offset+octet-stream' \
  --header 'tus-resumable: 1.0.0' \
  --data-binary 'file'

Headers de la solicitud

JSON Schema completo

Abrir JSON en una pestaña nueva

Encabezados normalizados en minúsculas para una solicitud PATCH canónica de tus.

Se aceptan campos adicionales a los enumerados para este objeto.

CampoTipo y descripción
content-type

obligatorio

string (siempre: "application/offset+octet-stream")
tus-resumable

obligatorio

string (siempre: "1.0.0")

La versión de tus negociada.

upload-length
string

Un recuento de bytes canónico, sin signo y en base 10, dentro del rango de 64 bits con signo, sin relleno de ceros ni signo más.

Patrón de validación (expresión regular)^(?:0|[1-9][0-9]{0,17}|[1-8][0-9]{18}|9[0-1][0-9]{17}|92[0-1][0-9]{16}|922[0-2][0-9]{15}|9223[0-2][0-9]{14}|92233[0-6][0-9]{13}|922337[0-1][0-9]{12}|92233720[0-2][0-9]{10}|922337203[0-5][0-9]{9}|9223372036[0-7][0-9]{8}|92233720368[0-4][0-9]{7}|922337203685[0-3][0-9]{6}|9223372036854[0-6][0-9]{5}|92233720368547[0-6][0-9]{4}|922337203685477[0-4][0-9]{3}|9223372036854775[0-7][0-9]{2}|922337203685477580[0-6]|9223372036854775807)$
upload-offset

obligatorio

string

Un recuento de bytes canónico, sin signo y en base 10, dentro del rango de 64 bits con signo, sin relleno de ceros ni signo más.

Patrón de validación (expresión regular)^(?:0|[1-9][0-9]{0,17}|[1-8][0-9]{18}|9[0-1][0-9]{17}|92[0-1][0-9]{16}|922[0-2][0-9]{15}|9223[0-2][0-9]{14}|92233[0-6][0-9]{13}|922337[0-1][0-9]{12}|92233720[0-2][0-9]{10}|922337203[0-5][0-9]{9}|9223372036[0-7][0-9]{8}|92233720368[0-4][0-9]{7}|922337203685[0-3][0-9]{6}|9223372036854[0-6][0-9]{5}|92233720368547[0-6][0-9]{4}|922337203685477[0-4][0-9]{3}|9223372036854775[0-7][0-9]{2}|922337203685477580[0-6]|9223372036854775807)$

Cuerpo de la solicitud

Cuerpo binario de la solicitud. application/offset+octet-stream

Respuesta

HTTP 204

Sin cuerpo de respuesta.

Headers de la respuesta
JSON Schema completo

Abrir JSON en una pestaña nueva

Se aceptan campos adicionales a los enumerados para este objeto.

CampoTipo y descripción
tus-resumable

obligatorio

string (siempre: "1.0.0")
upload-offset

obligatorio

string

Un recuento de bytes canónico, sin signo y en base 10, dentro del rango de 64 bits con signo, sin relleno de ceros ni signo más.

Patrón de validación (expresión regular)^(?:0|[1-9][0-9]{0,17}|[1-8][0-9]{18}|9[0-1][0-9]{17}|92[0-1][0-9]{16}|922[0-2][0-9]{15}|9223[0-2][0-9]{14}|92233[0-6][0-9]{13}|922337[0-1][0-9]{12}|92233720[0-2][0-9]{10}|922337203[0-5][0-9]{9}|9223372036[0-7][0-9]{8}|92233720368[0-4][0-9]{7}|922337203685[0-3][0-9]{6}|9223372036854[0-6][0-9]{5}|92233720368547[0-6][0-9]{4}|922337203685477[0-4][0-9]{3}|9223372036854775[0-7][0-9]{2}|922337203685477580[0-6]|9223372036854775807)$
x-content-type-options

obligatorio

string (siempre: "nosniff")

Respuesta de error

Cuerpo de respuesta de texto. text/plain; charset=utf-8

Esquema del cuerpo de la respuesta
JSON Schema completo

Abrir JSON en una pestaña nueva

string

Puede aplicarse cualquiera de los esquemas siguientes:

Variante 1: string
string
Patrón de validación (expresión regular)^ERR_[A-Z0-9_]+: [^\r\n]*\n$
Variante 2: string
string

Formato de error text/plain sin procesar de un hook con un payload literal; tiene aspecto de JSON, pero no es necesariamente JSON válido.

Patrón de validación (expresión regular)^\{"error":"(?:[\x09-\x0D\x20\xA0\u1680\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200a\u2028\u2029\u202f\u205f\u3000\ufeff]|[^\x09-\x0D\x20\xA0\u1680\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200a\u2028\u2029\u202f\u205f\u3000\ufeff])*"\}$
Headers de la respuesta
JSON Schema completo

Abrir JSON en una pestaña nueva

Se aceptan campos adicionales a los enumerados para este objeto.

CampoTipo y descripción
content-type

obligatorio

string (siempre: "text/plain; charset=utf-8")
tus-resumable

obligatorio

string (siempre: "1.0.0")
x-content-type-options

obligatorio

string (siempre: "nosniff")