Search
K
Upload Assets

Get closest Amazon S3 upload endpoint

Get the closest AmazonS3 upload endpoint.

get

Response

200 application/json

Successful response

string
get/api/upload/endpoint
 
200 application/json

Step 2 Initialise upload

This endpoint prepares the upload of a file in chunks. It returns a file ID that will be used in subsequent steps to upload the file chunks and finalize the upload.

Initialise upload

Initialise an upload.

post

Headers

Content-Typestringrequired

Body

application/x-www-form-urlencoded
filenamestring

Example:image.jpeg

Response

application/json

Successful response

ApiUploadInitResponse

multipart_paramsobject
Show Child Parameters
s3_filenamestring

Example:pluploads/api/00000000-0000-0000-0000-000000000000/image.jpeg

s3fileobject
Show Child Parameters
target_keystring

Example:pluploads/api/00000000-0000-0000-0000-000000000000/image.jpeg

post/api/upload/init

Body

{}
 
application/json

Step 3A Upload file in chunks

This endpoint uploads a chunk of the file. You need to provide the file ID obtained from the prepare upload step and the chunk number (starting from 0). The request body should contain the binary data of the chunk being uploaded.

Upload file in chunks

Uploading a file consists of the following two parts:

1. Breaking down your file into parts/chunks

Each part must be at least 5 MB in size, except for the last part. There is no size limit on the last part of your multipart upload. For more information about how Amazon handles parts/chunks, visit Amazon’s website.

2. Sending the chunks to Amazon and registering them with Bynder

You can repeat these calls until your file has been uploaded completely.

Upload a chunk

Make a POST request to the Amazon upload endpoint you received from calling Get closest AmazonS3 upload endpoint. Use multipart/form-data to send all of the parameters included in the multipart_params of the previous request, plus the additional parameters listed below.

post

Response

200
post/
 
200