Static storage

Overview

Architect gives you your own storage space for storing files of all types and sizes.
There are available two endpoints on your project API for managing files, /files and /files/bulk.

Currently, it's possible do upload only as an authorized user, so be sure that you include authorization headers.

Uploading a file

POST https://{app-id}.essentialz.cloud/files

To upload a single file, just send a request with multipart form data containing your file.

curl

Request

curl --location --request POST 'https://{app-id}.essentialz.cloud/files' \

--header 'Authorization: Bearer eyJhbGciOi...' \

--form 'file=@"/path/to/the/file/image.png"'

fetch

Request

const myHeaders = new Headers();

myHeaders.append("Authorization", "Bearer eyJhbGciOi...");

const formdata = new FormData();

formdata.append("file", fileInput.files[0], "image.png");

const requestOptions = {

method: 'POST',

headers: myHeaders,

body: formdata

};

fetch("https://{app-id}.essentialz.cloud/files", requestOptions)

.then(response => response.text())

.then(result => console.log(result))

.catch(error => console.log('error', error));

Response

{

"url": "https://s3.amazonaws.com/architect.bucket/{app-id}/upload_6b2ac5..."

}

Uploading files in bulk

POST https://{app-id}.essentialz.cloud/files/bulk

Uploading files in bulk works in a similar way as uploading a single file.

curl

Request

curl --location --request POST 'https://{app-id}.essentialz.cloud/files/bulk' \

--header 'Authorization: Bearer eyJhbGciOi...' \

--form 'files[]=@"/path/to/the/files/image1.png"' \

--form 'files[]=@"/path/to/the/files/image2.png"'

fetch

Request

const myHeaders = new Headers();

myHeaders.append("Authorization", "Bearer eyJhbGciOi...");

const formdata = new FormData();

formdata.append("files[]", fileInput.files[0], "image1.png");

formdata.append("files[]", fileInput.files[1], "image2.png");

const requestOptions = {

method: 'POST',

headers: myHeaders,

body: formdata

};

fetch("https://{app-id}.essentialz.cloud/files/bulk", requestOptions)

.then(response => response.text())

.then(result => console.log(result))

.catch(error => console.log('error', error));

Response

[

{

"url": "https://s3.amazonaws.com/architect.bucket/{app-id}/upload_54394c..."

},

{

"url": "https://s3.amazonaws.com/architect.bucket/{app-id}/upload_892c97..."

}

]