Downloads

MASV clients download files directly from MASV's private cloud infrastructure. The MASV API supplies authorized links in order to carry out the downloads from the MASV cloud.

MASV makes the following downloads available:

Each individual file that was uploaded as part of the package.
A zip file for Microsoft Windows and Linux platforms.
A zip file for macOS platforms.

1) Obtain package link information

The package link information can be obtained from the recipient's email. The package information requires the link_id and secret. (See the Links page for more details and examples.)

MASV Logo

ROUTE

Method	Route
`GET`	`/links/{{ link_id }}`

HEADERS

Name	Type	Required	Description
`X-Link-Password`	String	No	Sender supplied password associated with the package

URL Parameters

Name	Type	Required	Description
`secret`	String	Yes	Secret token associated with the download link

REQUEST

curl

curl -H "X-Link-Password: $PACKAGE_PASSWORD" \
-X GET "https://api.massive.app/v1/links/$LINK_ID?secret=$SECRET"

After a successful request the API will respond with status code 200 OK and a body response matching the JSON below.

Example JSON Response

{
  "branding": {
    "primary_color": "#1DD4CA"
  },
  "expiry": "2019-02-13T21:33:50.944Z",
  "id": "01D2TMG9F5GHMHX8RWZ453VA35",
  "name": "MASV Package",
  "package_id": "01D2TMG9F0J6JD5SJ55NY27MXJ",
  "package_size": 28176354,
  "package_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE1NDk5ODQ2OTksImltcCI6ZmFsc2UsImxpZCI6IjAxRDJUTUc5RjVHSE1IWDhSV1o0NTNWQTM1IiwibHZsIjoiZCIsInN1YiI6IjAxRDJUTUc5RjBKNkpENVNKNTVOWTI3TVhKIiwidHlwIjoicGFja2FnZSJ9.aq1f0UpKDPac8fkdOlPV2_S2eYBKOh-wUydv-GBFXZw",
  "recipient_email": "[email protected]",
  "sender_email": "[email protected]"
}

Note

The package_id and package_token are required to list the files associated with the package.

Note

Requests for packages containing greater than 10,000 files will be rate limited to once every 5 seconds.

2) Obtain file listing for the package

Method	Route
`GET`	`/packages/{{ package_id }}/files`

HEADERS

Name	Type	Required	Description
`X-Package-Token`	String	YES	Package token

URL Parameters

Name	Type	Required	Description
`package_id`	String	YES	Package ID obtained from step 1.

REQUEST

curl

curl -H "X-Package-Token: $PACKAGE_TOKEN" \
-X GET "https://api.massive.app/v1/packages/$PACKAGE_ID/files"

After a successful request the API will respond with status code 200 OK and a body response matching the json below:

Example JSON Response

[
  {
    "id": "01D2TMGA09VHKVW6G3MJH2EP57",
    "kind": "file",
    "last_modified": "0001-01-01T00:00:00.000Z",
    "name": "Hawaii_4_27Retina_L.jpg",
    "size": 14914472,
    "virus_detected": false
  },
  {
    "id": "01D2TMGA09RBKG9H29HVZPGSMX",
    "kind": "file",
    "last_modified": "0001-01-01T00:00:00.000Z",
    "name": "Hawaii_4_27Retina_R.jpg",
    "size": 13261882,
    "virus_detected": false
  },
  {
    "id": "01D2TMGZMRZNDWD3852NNASF4D",
    "kind": "zip_windows",
    "last_modified": "2019-02-03T21:34:13.655Z",
    "name": "windows.zip",
    "virus_detected": false
  },
  {
    "id": "01D2TMGZMSGYSXFB7MV5V9ZM0X",
    "kind": "zip_mac",
    "last_modified": "2019-02-03T21:34:13.657Z",
    "name": "mac.zip",
    "virus_detected": false
  }
]

Note

Files with virus_detected: true indicate that a virus has been detected in the file contents and it cannot be downloaded for security purposes. A 403 status code will be returned if an attempt is made to download it.

3) Obtain download links for the files in the package

Please note that direct file download URLs are short-lived and not intended for sharing or publishing. They are designed to be used immediately following the request. We recommend that you use the package download URL (i.e. https://get.massive.app/{link id}?secret={secret}), which is active until your package expires or you delete the package manually.

If you are building a custom download page, you can call the MASV API by using the method and route below to get the download URL on demand when the user is starting the download.

Method	Route
`GET`	`/packages/{package_id}/files/{file_id}/download`

HEADERS

Name	Type	Required	Description
`X-Package-Token`	String	YES	Package token

URL Parameters

Name	Type	Required	Description
`package_id`	String	YES	Package ID obtained from step 1.
`files_id`	String	YES	Files ID obtained from step 2.

REQUEST

curl

curl -H "X-Package-Token: $PACKAGE_TOKEN" \
-X GET "https://api.massive.app/v1/packages/$PACKAGE_ID/files/$FILES_ID/download"

After a successful request the API will respond with status code 200 OK and a body response matching the json below:

Example JSON Response

{
  "method": "GET",
  "url": "https://masv3-storage-stag-wdc.s3-accelerate.amazonaws.com/01D2TMG9F0J6JD5SJ55NY27MXJ/01D2TMGA09VHKVW6G3MJH2EP57?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAJT7DTCC6DRVEACYQ%2F20190205%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20190205T152017Z&X-Amz-Expires=86399&X-Amz-SignedHeaders=host&x-custom_id=01D20E4YGW8D777N8X0FF2F78P&x-custom_imp=0&x-custom_link_id=01D2TMG9F5GHMHX8RWZ453VA35&x-custom_pkg_id=01D2TMG9F0J6JD5SJ55NY27MXJ&X-Amz-Signature=fbfa915207a87c17a5bcb56442d08e16bfc8dda55ca2310b797e14480bd81e5c"
}

4) Download the file

Note

Direct file URLs should not be shared or published. See Obtain download links for the files in the package for details.

Request Parameters

Name	Type	Required	Description
`method`	String	YES	Method obtained from Step 3.
`url`	String	YES	URL obtained from Step 3.

REQUEST

curl

curl -X $METHOD $URL > /path/to/target/file