Pulling Tenant Data from VOCA CIC storage via API

To securely pull Tenant’s data from Voca Storage, use the following external APIs:

■

Get Token: https://<domain>/api/DataExport/External/token

■

Get Files: https://<domain>/api/DataExport/External/Files

Current Domain for All Voca CIC Environments

Region	Domain
IO	voca-dm.audiocodes.io
APAC	vocaau-dm.audiocodesaas.com
EMEA	voca-dm.audiocodesaas.com
INDIA	vocaindia-dm.audiocodesaas.com
AMER	vocaus-dm.audiocodesaas.com

Get Token: https://<domain>/api/DataExport/External/token

files using the `/api/DataExport/External/Files` API (see the next section).

Usage

■

URL: https://<domain>/api/DataExport/External/token

■

Method: GET

■

Request Headers: x-api-key: <user-api-key>

■

The API key is generated in the UI during the initialization process.

Responses

■

200 OK: Token generation was successful.

■

Example Response Body:

{"token": "123e4567-e89b-12d3-a456-426614174000"}

■

401 Unauthorized: Invalid API key

■

500 Internal Server Error: Failed to generate the token

Get Files: https://<domain>/api/DataExport/External/Files

This API is triggered by users to obtain download links to a tar file containing CSV files representing their data stored in the Voca Storage account. The user must provide a valid token, which can be retrieved using the `/api/DataExport/External/token` API.

Usage

■

URL: https://<domain>/api/DataExport/External/Files

■

Method: GET

■

Request Headers: `Authorization: Bearer <token>`

The token is generated via the /api/DataExport/External/token API.

Responses

■

200 OK: Successfully retrieved file URLs.

Example Response Body

[

"https://<AzureResourceName>.blob.core.windows.net/<containerName>/<fileName>.tar",

"https://<AzureResourceName>.blob.core.windows.net/<containerName>/<fileName>.tar"

]

■

401 Unauthorized: Invalid token.

■

500 Internal Server Error: Failed to retrieve file links.