DescriptionStarts an Encoding Job in the Media Encoding Cluster, the Job will be immediately queued to the Job list and processed when a free Encoding Slot is available.
Request Method
ActionUrl
Request Parameter Name | Description | Required | input | this can be a local file path or an http url to a webresource http url "infile":"http://codergrid/test.mp4" local file "infile":"/tmp/test.mp4" | yes
| output | this file or path can be a local filepath e.g. "output":"/tmp/result.m4v" | | indir | this loads a local directory, this is usefull for mass encoding from directory | yes in conjunction with outdir | profileid | the profile id from a profile to convert the infile to the requested format. "profileid":"072e8402-b401-48d3-a35e-414a485f18ba" | yes | outfile | the outfile can be a local file or a http url web resource. http url "outfile":"http://codergrid.de/result.avi" local file "outfile":"/tmp/result.avi" | yes in conjunction with infile | outdir | here will the resulting encodings placed generated by indir | yes in conjunction with indir | outfilepattern | defining the resulting filenames for the generated encodings by indir possible variables are: $filename -> this is the inputfilename without extension $extension -> this is the inputfile extension $profilename -> the profile name encode to $profileid -> the profile id encode to | yes in conjunction with indir |
Response Elements Name | Description | id | the id from the generated Encoding Job |
ExamplesExample Request for encoding a single file
URL: http://localhost:8080/api/v1/encoding JSON Payload:{
"infile":"/data/Movies/Die silicon Valley Story.avi",
"profileid":"072e8402-b401-48d3-a35e-414a485f18ba",
"outfile":"/tmp/test/Die silicon Valley Story.mp4"
}
Example Response {
"requestId":"7130581e-c62d-4b73-84db-f57fabc82dba",
"id":"1234abcd-b401-4321-1234-4321bcda1234"
}
Example Request for encoding a directory URL: http://localhost:8080/api/v1/encoding JSON Payload:{
"indir":"/data/Movies/",
"profileid":"072e8402-b401-48d3-a35e-414a485f18ba",
"outdir":"/tmp/test",
"outfilepattern":"$profileid.$fileanme.mp4"
}
Example Response {
"requestId":"7130581e-c62d-4b73-84db-f57fabc82dba",
"id":"1234abcd-b401-4321-1234-4321bcda1234"
}
Related Operations
|
|