1. Teleboard | Support Center
  2. Solution home
  3. API Documentation
  4. REST API - GET Requests
Open navigation

GET/call/recording

The GET/call/recording request returns a URL path for a downloadable MP3 audio recording of a particular call segment. 


The returned response Include the following field:


  • url - the URL path on the Telebroad server for the downloadable MP3 audio recording of a particular call segment.

    Note the the URL has a bit of a non-standrad format as it is specifically designed for working with the Telebroad servers and APIs. Some browsers will accept it and some won't. If your browser doesn't just replace the beginning part "https:\/\/..." with "https://".

Parameters


All parameters go in the header. 


Parameter
Type
Operation
callid
string
The ID for the call for which for the call recording is requested.

You obtain this ID using the GET/call/flow request, where it looks
like this -

"callid":"1526062490.371076"
uniqueid
string
A unique ID of the particular call flow segment for which the call recording is requested.

You also obtain this ID using the GET/call/flow request, where it looks like this -

"uniqueid": "1474440978.934821"

Example


To get the MP3 audio recording for a call segement "1587917545.183417" of call  "1587917545.183417" use this syntax:


HTTPS method: GET


webserv.telebroad.com/api/teleconsole/rest/call/recording?callid=1587917545.183417&uniqueid=1587917545.183417


Response:


If the recording cannot be found (double check the details of callid and uniqueid) -


"error": 

    { "code": 444, 

    "message": "Cannot find call" 

    } 

}


Otherwise -


{     

 error":null,

    "result": 

        { "url":

        "https:\/\/telebroad.blob.core.windows.net\/

        d78fa6b89477a3b5452a989bc107b5fc\/c43

        03e88ebc5f1538082113b69e19193.mp3" 

        }

}