Get An Upload Url

Get a signed url that an audio file can be uploaded to. The sha256 hash sent in the request querystring is used to check if a file matching that checksum already exists in our store.

Response

Two fields are returned in the body: uploadUrl and uploadId.
If the file already exists in our file store then "uploadUrl": null is returned
If the file does not exists, then a signed uploadUrl is generated.

Required Scope

user:content:manage

Responses

200 OK (Upload URL Created) / 200 OK (File Already Exists)application/json

uploadobject

uploadIdstring

uploadUrlstring

{
  "upload": {
    "uploadId": "zK3NQ1r-P7mQd9IjOKVFjlWnYAuGn3nHWTJSejljJcM",
    "uploadUrl": null
  }
}

Query Parameters

sha256string

The SHA256 hash of the source file to be uploaded. It is used to determine a successful upload (we SHA256 hash the file once it is uploaded to our file store and compare the hashes for a match)

Example{{sha256}}

filenamestring

(optional) the filename for the uploaded file

ExampleThis Is The Name I Want For The File

GET

/media/transcode/audio/uploadUrl

Server URL: https://api.yotoplay.com

Query Parameters

KEY	VALUE
sha256
filename

curl "https://api.yotoplay.com/media/transcode/audio/uploadUrl"