jotta-fs

Crates.iojotta-fs
lib.rsjotta-fs
version0.1.3
sourcesrc
created_at2022-03-12 22:52:40.123653
updated_at2022-03-20 20:30:04.40966
descriptionThird-party low-level Jottacloud client for Rust.
homepage
repositoryhttps://github.com/akeamc/jotta
max_upload_size
id548940
size48,264
Åke Amcoff (akeamc)

documentation

README

jotta-fs

Jotta FS is a thin wrapper around the Jottacloud REST API.

Jottacloud API Discoveries

Uploading

You need to allocate before uploading:

POST https://api.jottacloud.com/files/v1/allocate

The JSON body must contain an md5 field, which makes streaming complicated.

A successful allocation will return an upload_url that you can POST the data to.

Chunked uploads

Uploads can be easily chunked by POSTing to the previously obtained upload_url with the desired chunk and a Range header specifying where in the complete file this chunk is located.

Jottacloud will return an HTTP 420 error (whatever that is) and an IncompleteUploadOpenApiException, but it does work. Trust me. The next allocation call will have a new resume_pos field.

  • There doesn't seem to be any minimum for the chunk size. Tested with 1 byte per request.
  • There is no need to allocate between every chunk (upload_url can be reused). (might be false)
  • resume_pos is available at the file metadata endpoint too.
Commit count: 57

cargo fmt