COMMAND.9 Create delivery authorization

Overview

This command creates a delivery authorization valid for a max number of retries (maxRetries parameter) and a time to live (ttlInSeconds parameter). This command might perform a redirection (redirect parameter) with the download URL. In this case it is not needed to call the download command because it is activated automatically by the redirection.

URI

/catramms/v1/delivery/:PhysicalPathKey?[:ttlInSeconds=120]&[:maxRetries=10]&[:redirect=false]

Method

GET

URL Params

Required

PhysicalPathKey: key of the specific file to be authorized for the download

Optional

• ttlInSeconds: time to live in seconds of the authorization
  • default: 120
• maxRetries: max number of retries of the authorization
  • default: 10
• redirect: it specifies if this command has to perform a redirection or it has to return a json with several information
  • default: false

Payload Data

None

Success Response

Code

301 Moved Permanently in case the redirect parameter is true 201 Created in case the redirect parameter is false

Content

Only in case the redirect parameter is false

{ 
    "deliveryURL": "http://mms-delivery.catrasoft.cloud/MMS_0000/CatraSoft/000/000/561/833_source.mp4?token=4&outputFileName=myName.mp4",
    "outputFileName": "myName.mp4", 
    "authorizationKey": 4, 
    "ttlInSeconds": 120, 
    "maxRetries": 10 
}

Error Response

See Common Error Responses

Sample Call

Assuming:

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

curl -k -v -u 5:SU1.8ZO1O2zVeBMNv9lzZ0whABXSAdjWrR~rpcnI5eaHNO2gysrNdAv8BNoWZB1eLP https://mms-api.catrasoft.cloud/catramms/v1/delivery/663

curl -k -v -u 5:SU1.8ZO1O2zVeBMNv9lzZ0whABXSAdjWrR~rpcnI5eaHNO2gysrNdAv8BNoWZB1eLP https://mms-api.catrasoft.cloud/catramms/v1/delivery/663?redirect=true