Accessing secure logs and recordings

One-time key authorization

When creating (or editing) an application, you get to choose how to store your logs and recordings. We recommend that you enable the secure mode, so your logs and recordings are not accessible to everyone via the link.

You can do the same using the AddApplication and SetApplicationInfo methods of our management API.

Recordings support the Range HTTP request header. It indicates the part of a document that the server should return. Use it for large recordings, so you do not have to wait for the whole video to load, but instead can load it in parts.

Secure objects (recordings and logs) require authorization. You can authorize with:

1. A service account
2. An API key (deprecated)

The first option is preferable. A service account is a way to grant access to the Voximplant Management API on behalf of your main account. Here is how you can access secure objects:

1. Create a new service account and generate a JSON with credentials in the control panel (Add → Generate a key).

2. If you are going to make a request using cURL, create a JSON Web Token (click the link to learn how).
3. Make a request to a secure object using one of the API clients.

Curl sample

When you generate the token, make a simple curl request to obtain your recording:

$
curl -H "`bash token.sh`" "link_to_your_recording_or_log"

You can save the recording or log to a file by adding -o file_name.file_format to your request:

$
curl -H "`bash token.sh`" "link_to_your_recording" -o my_recording.mp3

Python sample

Some API SDKs have special functions for adding auth data to requests to download recordings, like VoximplantAPI.build_auth_header in Python. Here is how one can use it to obtain a secure object:

1
import requests
2
from voximplant.apiclient import VoximplantAPI
3
4
voxApi = VoximplantAPI("credentials.json")
5
auth_header = voxApi.build_auth_header()
6
response = requests.get("link_to_your_recording_or_log", headers={"Authorization": auth_header})
7
8
print(response)

To save a recording, you can add this code to your python script:

1
with open("my_recording.mp3", "wb") as f:
2
    f.write(response.content)

To save a log – this code:

1
with open("my_log.txt", "wb") as f:
2
    f.write(response.text)