API Errors

If you wish to stop the processing of any medaID via API, send the action 'StopMedia.' 

Example: 

<?xml version="1.0"?>
<query>
<action>StopMedia</action>
<userid>[UserID]</userid>
<userkey>2a595f16aefdfbd1e3d7bf9952229bfa</userkey> 
<mediaid>[MediaID]</mediaid>
</query>

There's a little bit of similarity in a few of the Restart actions in the API. Here's the breakdown:

+ RestartMedia:  This will completely restart the entire job, including all tasks.

+ RestartMediaErrors:  This action will retry specific tasks within the request that produced an error. For example, if you received a 404 error on a file and remedied the issue, this action will successfully rerun only that task. 

+ RestartMediaTask:  This action requires an additional parameter. You can specify to rerun a specific task within a MediaID. For more information on the difference between MediaIDs and TaskIDs, please go here.

If you having issues with posting your XML to http://manage.encoding.com from your scripted workflow, please make sure that you have added the following:

Content-Type: application/x-www-form-urlencoded

This helps to avoid errors such as:

<?xml version="1.0"?>
<response>
<errors>
<error>Wrong XML!String could not be parsed as XML</error>
</errors>
</response>

Unforuntely at this time, the notify field only allows one URL or email address. This can be either an HTTP(S) URL for the script with which the result will be posted, or a mailto: link with email address for which the result info will be sent. Note that this field may be specified for AddMedia and AddMediaBenchmark actions.

If you've received the 'Wrong Media ID' error, then the media with such ID was not found. Suggested API Actions: UpdateMedia, GetStatus

If you've received the 'Source file is not indicated' error message then the SourceFile parameter is empty. Suggestion API Actions: AddMedia, UpdateMedia

If you've received the error message, "Wrong source file URL", then the url provided in the query does not match our supported format list. Suggested API Actions: AddMedia, UpdateMedia

If you've received the error message, 'MediaID is not indicated', then the MediaID parameter is omitted in the query. Suggested API Actions: UpdateMedia, GetStatus

If you've received the Invalid Action' error message, then the action parameter is empty or has not in the list of allowed actions

If you've received the "Wrong query format," then XML does not contain root element. Please check your XML and resubmit.

If you've received the 'Output format [Output] is not allowed' then the

element of the format is not in the list of allowed formats. Please verify that you've chosen an output format that is supported by encoding.com. Check the link below for our suggested formats: http://www.encoding.com/wdocs/SourceFileFormats Suggested API Actions: AddMedia, UpdateMedia

If you've received 'No format specified' error, then the [output] element of the format is omitted or has an empty value. Suggested API Actions: AddMedia, UpdateMedia

If you've received the 'Wrong XML' error message, then the XML query provided in the request is not well-formed. Please check your syntax and resubmit.

If you've received the error message 'No XML', then there was no XML provided in the request. Please include the XML in your request and resubmit.