COMMAND.4 Push Binary upload

Overview

This API is used to upload the Binary into the MMS.

URI

/catramms/v1/binary/:ingestionJobKey

Method

POST

URL Params

Required

• ingestionJobKey=[number] this field has to be the IngestionJobKey returned in the previous step. This field is important because it will be the key used by MMS to associate the binary to the previous ingested metadata example: ingestionJobKey=12

Optional

None

Payload Data

Source binary (i.e. binary file)

Success Response

Code

201 Created

Content

{ "contentLength": 6596335616, "writtenBytes": 6596335616, "elapsedUploadInSeconds": 25 }

Error Response

See Common Error Responses

Sample Call

Assuming:

• UserKey: 5
• APIKey: SU1.8ZO1O2zVeBMNv9lzZ0whABXSAdjWrR~rpcnI5eaHNO2gysrNdAv8BNoWZB1eLP
• IngestionJobKey: 16

Single request:

curl -v -X POST -u 5:SU1.8ZO1O2zVeBMNv9lzZ0whABXSAdjWrR~rpcnI5eaHNO2gysrNdAv8BNoWZB1eLP -T score.mpg http://mms-binary.catrasoft.cloud/catramms/v1/binary/16

Multiple chunks:

In this scenario the media binary file is split in several chunks and the single chunks, one by one, are sent. It is already implemented the ingestionThroughChunks.sh script taking care of all the steps to do. In alternative, here follows all the steps to be done.

Let's assume the size of score.mpg is 209246 and we want to split it with chucks of 100000, the commands to run will be:

dd status=none if=score.mpg bs=1024 iflag=skip_bytes,count_bytes skip=0 count=100000 | curl -s -o /dev/null -w "%{response_code}" -X POST -H "Content-Range: bytes 0-99999/209246" -u 5:SU1.8ZO1O2zVeBMNv9lzZ0whABXSAdjWrR~rpcnI5eaHNO2gysrNdAv8BNoWZB1eLP --data-binary @- "http://mms-binary.catrasoft.cloud/catramms/v1/binary/16"

dd status=none if=score.mpg bs=1024 iflag=skip_bytes,count_bytes skip=100000 count=100000 | curl -s -o /dev/null -w "%{response_code}" -X POST -H "Content-Range: bytes 100000-199999/209246" -u 5:SU1.8ZO1O2zVeBMNv9lzZ0whABXSAdjWrR~rpcnI5eaHNO2gysrNdAv8BNoWZB1eLP --data-binary @- "http://mms-binary.catrasoft.cloud/catramms/v1/binary/16"

dd status=none if=score.mpg bs=1024 iflag=skip_bytes,count_bytes skip=200000 count=9246 | curl -s -o /dev/null -w "%{response_code}" -X POST -H "Content-Range: bytes 200000-209245/209246" -u 5:SU1.8ZO1O2zVeBMNv9lzZ0whABXSAdjWrR~rpcnI5eaHNO2gysrNdAv8BNoWZB1eLP --data-binary @- "http://mms-binary.catrasoft.cloud/catramms/v1/binary/16"

Remark:

• In case the Content-Range start is 0, the system reset the binary if it exists and considers the chunk as the first chunk of the content
• In case the Content-Range end + 1 is equal to the Content-Range Size, the system considers the chunk as the last chunk of the content and proceeds to ingest the content