putTrackFile.rest

This service does not actually upload a file. Instead, it returns information required for the client to be able to upload a file to the server. In other words, this service provides the information needed to begin an upload. The caller must invoke this method first before beginning an upload. After the file is successfully uploaded, the client must then call the putTrack.rest service to commit the file to a project.

The use case is:

  1. Call this service prior to beginning an upload. Use return data from this service to use for the upload.
  2. Upload the file to Amazon S3.
  3. Call putTrack.rest to commit (complete) the upload.

Note that uploads are direct to Amazon S3. The client must PUT the file to the Amazon server using the new name 'uploadFileName' provided in the response from this service. Please see the Amazon API documentation for details. Then, after the upload is complete, the client must invoke the putTrack.rest service to commit the file to a project. You must Contact Us to obtain Amazon S3 access credentials.

Param Name Req Type Description
fileName Y String The name of the file (relative name) that is to be uploaded to the server.
sizeInBytes Y Number The size of the file in bytes.
client Y String The name and version number of the client application uploading the file (e.g., "acme-client/1.0"). Note: A valid/unique client name is required before uploading a file.
Contact Us to obtain a valid client name.