tus/tus-resumable-upload-protocol
Tus Resumable Upload Protocol
The project defines an open protocol specification for reliable, chunked, and resumable file transmission over standard HTTP infrastructure. It standardizes client-to-server file transfers across networks, enabling interrupted uploads to resume seamlessly without data loss or retransmitting completed chunks.
The protocol manages file upload lifecycles through resource-based session initialization, offset-based byte range tracking, and cryptographic checksum verification to validate incoming data blocks. Additional capabilities include parallel chunk concatenation for joining multiple partial uploads into a single file, creation-time data attachment to reduce network round trips, and automatic expiration garbage collection to reclaim storage from abandoned upload resources.
The specification also supports API integration features such as OpenAPI definition export and client and server code generation across languages.
Features
- HTTP File Uploads - Provides an open protocol specification for reliable client-to-server file transmission across networks using standard HTTP.
- HTTP Resumable Transfers - Standardizing file transfers over HTTP so that interrupted uploads resume seamlessly without data loss.
- Concatenations - The resumable upload library combines separate partial uploads into a single final file to support parallel chunk transfers and non-contiguous uploads.
- Upload Verification - The resumable upload library checks uploaded chunks against cryptographic checksums provided in requests to ensure data is received without corruption.
- Byte-Range Requesting - Transfers files in sequential chunks by tracking byte offsets over standard HTTP headers to allow seamless resumption after network failures.
- Large File Uploads - Connecting file transfer features into existing web applications with support for parallel chunk transfers and integrity checks.
- HTTP Upload Clients - The resumable upload library connects file transfer features into existing web applications using standard HTTP proxies, firewalls, and client libraries.
- Protocol Specifications - Defines the protocol specification for chunked file transfers over standard HTTP infrastructure with pause and restart support.
- Resumable Upload Clients - The resumable upload library recovers interrupted file transfers by querying the current offset and continuing transmission from that point without restarting.
- Cryptographic Verification - Validates incoming data blocks against cryptographic hash values included in transfer requests to guarantee transmission integrity.
- Session Initializations - The resumable upload library creates new upload resources on the server to establish endpoints for subsequent data transfer requests.
- Session Terminations - The resumable upload library deletes completed or unfinished upload sessions on demand to release occupied server resources.
- Creation-Time Data Attachments - The resumable upload library transfers file chunks alongside the initial creation request to reduce the number of round trips needed to start uploading.
- Parallel Concatenations - Joins multiple separate partial uploads into a single final file on the server to support concurrent transmission and non-contiguous transfers.
- Resource-Based Initializers - Creates dedicated server endpoints for each transfer session to track progress and manage resource lifecycle independently.
