API : Voice : Playback

Introduction

This request is used to playback or download an audio files that was previously generated using TTS and stored for later playback.

When downloading, ensure to download the right version.

Please note that audio files are accessed directly on the audio servers, not on the API servers.

Request

URL	https://audio.telecomx.dk/AUDIO_ID.FORMAT
URL	https://audio.telecomx.dk/AUDIO_ID/FILENAME.FORMAT
Method	GET
Access level	PERSONAL, VIEWER, MANAGER or OWNER if audio belongs to the customer or no one. RESELLER if customer belongs to the reseller, and the audio does not below to an employee. RESELLER_ADMIN or ADMIN, if the audio does not belong to an employee.
Params	AUDIO_ID	String	Id of the audio item.
	FORMAT	String	Format of the file to download - see list below for valid options.
	FILENAME	String	If the second URL format is used, a filename for the download can be specified, so that the file has a better name. This also forces download (is an attachment).
Args	token	String	Currently logged on users token, if audio belongs to an customer and/or employee - see login.

Format	Description
alaw	64Kbit 8KHz A-Law raw mono
ulaw	64Kbit 8KHz Mu-Law raw mono
mp3	128Kbit MP3 mono/stereo
wav	8-256Kbit Microsoft wave mono/stereo
gsm	13Kbit 8KHz GSM mono
m4a	128Kbit Apple AAC in m4a container mono/stereo
sln16	16Kbit wideband signed linear mono
high.mp3	256Kbit MP3 mono/stereo
low.mp3	8Kbit MP3 mono
g722	16Kbit wideband mono

Request example

http://audio.telecomx.dk/123457890ABCDEF12345678.mp3?token=1234578910478945613215
http://audio.telecomx.dk/123457890ABCDEF12345678/my-welcome-message.mp3?token=158948153187945613166

Response

Binary data - the audio file.

Example

N/A

Errors

Error code	Message	Description
404	id	Not found
403	access_denied	Insufficient access level
500	internal_error	<Unspecified>

WIKI

Table of Contents