/sapi/awsupload


The Blue Billywig Online Video Platform relies on AWS S3 for its file storage. AWS S3 is an extremely scalable and robust online storage environment. Every Online Video Platform customer has a dedicated AWS s3 bucket. Creating a new Media Clip (audio or video item) in the Online Video Platform typically means 3 steps need to be taken:

  1. An upload session needs to be registered
  2. A Media Clip needs to be registered
  3. A file upload to the AWS S3 bucket needs to be initiated and related to the upload identifier that is received in step one.

GET /sapi/awsupload can be used to register an upload session to the Amazon Webservices S3 service. It returns an object identifier and path.

Example response:

{
accessKey:"15WMNN3RJ8FA6ED86C02"
acl:"public-read-write"
currentDate:"Fri, 10 Aug 2018 09:59:00 +0200"
endpoint:"s3-eu-west-1.amazonaws.com/eu-vms-dev-storage"
path:"upload/bb.dev/2018/08/10/f1afb28a8b2c227e87dd983da91a4a1d"
region:"eu-west-1"
uploadIdentifier:"f1afb28a8b2c227e87dd983da91a4a1d"
}

The returned accessKey should be ignored. Contact support for your own set of AWS IAM credentials. Endpoint points to the canonical AWS S3 end point URL. Path is the “folder name” you should use for your upload.

UploadIdentifier specifies a unique hash. This is your “ticket”. You can use it as a reference once you’ve uploaded your file.

Updated on July 8, 2020

Was this article helpful?

Related Articles