Was ist tus?
tus ist ein offenes HTTP-Protokoll für fortsetzbare Datei-Uploads. Ein Client erstellt oder findet eine Upload-Ressource, sendet Bytes ab bekannten Offsets und fährt nach einer Unterbrechung ab dem bestätigten Offset fort.
So funktioniert tus
Das tus-Protokoll stellt einen laufenden Upload als HTTP-Ressource mit einer vom Server bestätigten Byteposition dar. Ein Client hängt Daten nur an dieser Position an und kann die Ressource nach dem Wiederherstellen der Verbindung abfragen. So vermeidet er die erneute Übertragung bereits akzeptierter Bytes. Der Protokollkern ist schlank, während ausgehandelte Erweiterungen die Erstellung, Prüfsummen, Ablaufzeiten, Verkettung oder eine spätere Festlegung der Länge ergänzen. In einem Workflow zur Datenübernahme trennt tus den zuverlässigen Übertragungszustand von der späteren Validierung, Transkodierung und Veröffentlichung.
Wichtige Fakten
- Ein Client sendet eine PATCH-Anfrage mit
Upload-Offset, und der Server akzeptiert sie nur, wenn dieser Wert mit dem gespeicherten Zustand übereinstimmt. Ein Offset-Konflikt verhindert, dass Bytes stillschweigend an der falschen Stelle angehängt werden. - HEAD ruft den aktuellen Offset des Servers ab, damit ein Client nach einer Unterbrechung fortfahren kann, während der Header
Tus-Resumabledie für kompatible Anfragen und Antworten erwartete Protokollversion angibt. - Optionale Erweiterungen für Prüfsummen und Ablaufzeiten behandeln unterschiedliche Fehlerfälle: Die eine erkennt beschädigte Datenblöcke, die andere teilt Clients mit, dass eine Ressource für einen unvollständigen Upload künftig möglicherweise nicht mehr existiert.
Wann tus wichtig ist
Wählen Sie tus für große Uploads oder unzuverlässige Verbindungen, bei denen ein Neustart der gesamten Übertragung aufwendig wäre. Client- und Serverimplementierungen müssen bei Offsets und Erweiterungen übereinstimmen, sonst kann das Fortsetzen scheitern.