Creates an acceptor which receives an HTTP POST binary upload. The acceptor will be opened on a specified port and the uploaded media file will be written on a specified directory. The acceptor then waits for an HTTP POST from a client with the media file as payload. The media file is then written on the specified location in the server.
API Parameter Table
Parameter Name | Type | Mandatory | Default Value | Description |
---|---|---|---|---|
port | integer | true | null | The port value to bind on |
targetFolder | string | true | null | The folder where the binary upload will be serialized |
API Call Template
uploadMedia port=<portNumber> targetFolder=<targetFolder>
Sample API Call
uploadMedia port=3333 targetFolder=../media
Success Response in JSON
{
"data":{
"ip":"0.0.0.0",
"port":3333,
"targetFolder":"..\/media"
},
"description":"Media upload acceptor configuration.",
"status":"SUCCESS"
}
JSON Response
The JSON response contains the following details:
- data – The data to parse
- ip – The IP referring to the EMS, normally 0.0.0.0
- port – The specified port number where the acceptor will wait for HTTP POSTs
- targetFolder – The specified folder where the media file will be written
- description – Describes the result of parsing/executing the command
- status – SUCCESS if the command was parsed and executed successfully, FAIL if not.
Notes
- The sending client must conform to the following:
- It must send the data by way of HTTP POST
- The POST request must be in http/1.1 format
- A StreamName must be provided in the POST line. This will then be the filename of the media file (mp4) when written. (e.g., POST /mystreamname HTTP/1.1\r\n)
- Content-type must be set to video/mp4 or application/octet-stream
- Content-length must be used. This function is intended for uploading VOD MP4 so the EMS will expect that the size of the file is already known