Marvia Developer Portal

Large files are uploaded using a multipart upload process. This makes uploads more reliable and efficient, especially for big files or unstable connections.

The following repository provides reference implementations and examples showcasing how to integrate with Marvia's API upload endpoints: marvia/api-upload-examples

Process Overview

The process involves three main steps:

Initialize the multipart upload - Initialize multipart upload

Upload each part to the pre-signed URLs returned

Complete the multipart upload with the part checksums (ETags) - Complete multipart upload

The sequence diagram below visually explains the expected integration flow.

1. Initialize Multipart Upload

Call the initialize endpoint with the following file metadata:

fileName

fileSize

Response includes:

A temporary uuidfor tracking

An array of parts with { partNumber, url } where each part must be uploaded

2. Upload Each Part

For each part:

Use the provided pre-signed URL

Upload with an HTTP PUT request

Record the ETag from the response headers (this is required later)

Example (cURL)

3. Complete Multipart Upload

Once all parts are uploaded and you have their ETags, call the complete endpoint with:

The uuid from step 1

An array of { partNumber, ETag } for each uploaded part

Example request body:

{
  "uuid": "UPLOAD-ID-FROM-INIT",
  "parts": [
    { "partNumber": 1, "ETag": "etag-part-1" },
    { "partNumber": 2, "ETag": "etag-part-2" },
    { "partNumber": 3, "ETag": "etag-part-3" }
  ]
}

Response includes:

Final fileUuid

Public or signed url to the completed file

Summary

Use Initialize Multipart Upload to start and get pre-signed part URLs.

Upload all parts directly to storage, keeping track of each ETag.

Call Complete Multipart Upload with the collected ETags.

The API responds with the final fileUuid and accessible file URL.

Uploading Files

Process Overview#

1. Initialize Multipart Upload#

2. Upload Each Part#

3. Complete Multipart Upload#

Summary#

Process Overview

1. Initialize Multipart Upload

2. Upload Each Part

3. Complete Multipart Upload

Summary