2.2 KiB

Raw Blame History

tus

A dedicated server for resumable file uploads written in Go.

Roadmap

The goal for this code base is to come up with a good and simple solution for resumable file uploads over http.

Defining good http API
Implementing a reasonably robust server for it
Creating an HTML5 client
Setting up an online demo
Integrating Amazon S3 for storage
Creating an iOS client
Collect feedback

After this, and based on the feedback, we will continue the development, and start to offer the software as a hosted service. All code will continue to be released as open source, there will be no bait and switch.

HTTP API

`POST /files`

Request

POST /files HTTP/1.1
Host: tus.example.com
Content-Length: 0
Content-Range: bytes */100
Content-Type: "image/png"

Response:

HTTP/1.1 201 Created
Location: http://tus.example.com/files/123d3ebc995732b2

{
  "id": "123d3ebc995732b2",
  "url": "http://tus.example.com/files/123d3ebc995732b2",
  "received": 0,
  "size": 0,
  "parts": []
}

In this case the client would proceed by querying the server:

`GET /files/123d3ebc995732b2`

Request:

GET /files/123d3ebc995732b2/d930cc9d304cc667 HTTP/1.1
Host: tus.example.com
Content-Length: 0
Content-Range: bytes */*

The server responds by informing the client about the status of the partial upload:

Response:

HTTP/1.1 206 Partial Content
Content-Length: 0
Content-Range: 0-49/100

@TODO Document resume operation

License

This project is licensed under the AGPL v3.

Copyright (C) 2013 Transloadit Limited
http://transloadit.com/

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.

2.2 KiB Raw Blame History

tus