Release NotesUser InterfaceSystem Status
API Reference

Retranslation Endpoints

If you don’t have an RTMP broadcasting server you can use our Retranslation Endpoint service.
To use it you need the Endpoint URL which can be requested or found in the UI. Set this as the endpoint in your streaming tool, and set it as your Media Source in the API request.

Add Endpoint

REQUEST

📘

Note

There is a limit of 10 endpoints.

<?xml version="1.0"?>
<query>
    <userid>[UserID]</userid><!-- REQUIRED -->
    <userkey>[UserKey]</userkey><!-- REQUIRED -->
    <action>AddStreamEndpoint</action>
</query>

{
    "query": {
        "userid": "[UserID]",
        "userkey": "[UserKey]",
        "action": "AddStreamEndpoint"
    }
}

RESPONSE 

<?xml version="1.0"?>
<response>
    <endpoint>
        <rtmp>
            <url>rtmp://stream.encoding.com/live/[EndpointToken]</url>
            <credentials>
                <host>stream.encoding.com</host>
                <port>1935</port>
                <app_name>live</app_name>
                <stream>[EndpointToken]</stream>
            </credentials>
        </rtmp>
    </endpoint>
</response>

{
    "response": {
        "endpoint": {
            "rtmp": {
                "url": "rtmp://stream.encoding.com/live/[EndpointToken]",
                "credentials": {
                    "host": "stream.encoding.com",
                    "port": "1935",
                    "app_name": "live",
                    "stream": "[EndpointToken]"
                }
            }
        }
    }
}

Get Endpoints

REQUEST 

<?xml version="1.0"?>
<query>
    <userid>[UserID]</userid><!-- REQUIRED -->
    <userkey>[UserKey]</userkey><!-- REQUIRED -->
    <action>GetStreamEndpointList</action>
</query>

{
    "query": {
        "userid": "[UserID]",
        "userkey": "[UserKey]",
        "action": "GetStreamEndpointList"
    }
}

RESPONSE 

<?xml version="1.0"?>
<response>
    <endpoint>
        <status>[inactive|online]</status>
        <rtmp>
            <url>rtmp://stream.encoding.com/live/[EndpointToken]</url>
            <credentials>
                <host>stream.encoding.com</host>
                <port>1935</port>
                <app_name>live</app_name>
                <stream>[EndpointToken]</stream>
            </credentials>
        </rtmp>
    </endpoint>
</response>

{
    "response": {
        "endpoint": {
            "status": "[inactive|online]",
            "rtmp": {
                "url": "rtmp://stream.encoding.com/live/[EndpointToken]",
                "credentials": {
                    "host": "stream.encoding.com",
                    "port": "1935",
                    "app_name": "live",
                    "stream": "[EndpointToken]"
                }
            }
        }
    }
}

Delete Endpoints

<?xml version="1.0"?>
<query>
    <userid>[UserID]</userid><!-- REQUIRED -->
    <userkey>[UserKey]</userkey><!-- REQUIRED -->
    <action>DeleteStreamEndpoint</action>
    <endpoint>[EndpointURL]</endpoint>
</query>

{
    "query": {
        "userid": "[UserID]",
        "userkey": "[UserKey]",
        "action": "DeleteStreamEndpoint",
        "endpoint": "[EndpointURL]"
    }
}