API Reference

Register uploaded chunk

Register the completion of an uploaded chunk.


Uploading a file consists of the following two parts:

  • Breaking down your file in parts/chunks. Each part must be at least 5 MB in size, except 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.
  • Sending the chunks over to Amazon and then registering them to Bynder. You can repeat those calls up until your file has been uploaded completely.
  1. Upload a chunk Make a POST request to the Amazon upload endpoint you received from calling Get closest AmazonS3 upload endpoint. Use a multipart/form-data to send all of the parameters that the multipart_params of the previous request included; plus the following additional parameters:
NameValueType
'Content-Type'Content type extracted from the multipart_params's Content-Type of the response of the initialise upload request.string
'Policy'Policy extracted from the multipart_params's Policy of the response of the initialise upload request.string
'X-Amz-Signature'Signature extracted from the multipart_params's X-Amz-Signature of the response of the initialise upload request.string
'acl'Access control list extracted from the multipart_params's acl of the response of the initialise upload request.string
'key'Key extracted from the multipart_params's key of the response of the initialise upload request followed by p{Chunk index number}. Example: "pluploads/12345/image.png/p1".string
'success_action_status'Success action status extracted from the multipart_params's success_action_status of the response of the initialise upload request.string
'x-amz-algorithm'Algorithm extracted from the multipart_params's x-amz-algorithm of the response of the initialise upload request.string
'x-amz-credential'Credential extracted from the multipart_params's x-amz-credential of the response of the initialise upload request.string
'x-amz-date'Date extracted from the multipart_params's x-amz-date of the response of the initialise upload request.string
'name'Filename that was passed as attribute in the initialise upload request.string
'chunk'Chunk index number (indexing starts from 1).number
'chunks'Total number of chunks.number
'Filename'The value of the key from the multipart_params of the response of the initise upload request followed by p{Chunk index number}. Example: "pluploads/12345/image.png/p1". ATTENTION: Filename must start with capital F.string
'File'File or chunk of the file to be uploaded.byte array
  1. Register uploaded chunks After uploading a chunk, you must register it's completion to Bynder.
  2. Finalise a completely uploaded file.

Attributes

targetid (required)

string Target id as returned by the initialise call. final/E3333526-7F87-49F9-B49C0054C0D31477/Logo.png

s3_filename (required)

string Base location of the uploaded file. api_uploads/159D8D4B-B981-49B8-BF0569FD144CB359/A29FABF0-26B8-44BF-890920E4C09E7C11/Logo.png

chunks (required)

number Total number of chunks uploaded.

original_filename

string Filename including special characters to be displayed in Bynder.

Language
Credentials
URL
Click Try It! to start a request and see the response here!