Webrtc
Call Record
Retrieve call record link via API
Call Record
Details
| Description | The "Call Record" endpoint returns a link to the call record |
|---|---|
| HTTP Method | GET |
| Endpoint URL | https://platform.innocalls.com/api/v1/api-gateway/cdr/download-record/:callId |
| Authorization | To access the API endpoints, you need to authenticate using API keys and API secrets. The API supports Basic Authentication for authorization. You need to include your API ID as the username and your API secret as the password in the HTTP header when making requests. Replace API_ID with your API ID and API_SECRET with your API secret, separated by a colon (:). The value after Basic is the Base64 encoding of your API key and API secret concatenated with a colon. |
| Rate Limit | 3 requests per second |
Request Parameters
| Parameter | Description | Location | Constrains |
|---|---|---|---|
| callId | The callId that obtained from callStarted event | Path | Required |
Request Example
curl 'https://platform.innocalls.com/api/v1/api-gateway/cdr/download-record/:callId' \
--header 'Authorization: Basic <base64-encoded string apiId:apiSecret>'Success Response Example
{
"data": {
"recordPath": "https://path.to/record/file.wav"
}
}Description
This JSON response signifies a successful retrieval of the call record.
recordPath: The URL path to the call record file.
Possible Errors
| Error Code | Description |
|---|---|
| 401 Unauthorized | Invalid Credential |
| 403 Forbidden | Not Enough Permissions to access the resource |
| 429 Too Many Requests | This occurs when requests exceed the rate limit |
| 429 NOT FOUND | The requested call record was not found |
