Articles in this support section discuss Telebroad's legacy APIs. To learn about the current version of Telebroad APIs, which offer additional authentication options and support for advanced features, please go to https://developers.telebroad.com/.
The specific current version of the the GET/call/recording API is discussed here.
Function and Response Field
The GET/call/recording request returns a URL path for a downloadable MP3 audio recording of a particular call leg.
The returned response has one field:
- url - the URL path on the Telebroad server for the downloadable MP3 audio recording of a particular call leg.
Note that the URL has a somewhat non-standard format as it is mean to work 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 of "https:\/\/..." with "https://".
Parameters
All parameters go in the header.
| Parameter | Type | Operation |
| callid | string | The ID for the call for which 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 leg 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 leg "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 (you hdouble 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"
}
}