API descarga audio de llamado de Clickfono


Para el uso de la API de Clickfono en aplicaciones que requieren, o se benefician, del uso de la grabación de la llamada mediante un webservice  es necesario de un endpoint que pueda entregar el audio (archivo) de llamada.

Este documento explica el dicho endpoint, con sus parámetros y salidas esperables.

Uso del servicio

Invocación

El servicio se trata de un procedimiento remoto que se invoca a través de HTTP, por método GET.

Éste recibe como parámetro el UUID que identifica la llamada al ser pedida a través de la API de llamados de Clickfono. La interfaz sería la siguiente:

URLhttps://clickandtalk.medularis.com/recordings/{uuid}
MétodoGET
Parámetrosuuid: string representando el UUID que identifica la llamada.
HeadersSECURITY_TOKEN: API Token Clickfono

Nota: Si quiere conocer como  es el proceso de la generación de security_token

Un ejemplo de invocación, desde consola, es la siguiente:

curl 
'https://clickandtalk.medularis.com/recordings/cc97f690180049f8e0b7cb57bc4d856b' 
-H 'Security-Token: MI_TOKEN'

Respuestas

200 OK:

La respuesta es un binario en formato WAV que es la grabación del último intento de la llamada segun su uuid

Contiene la siguiente información en los headers 

Content-Disposition: inline; 
filename="cc97f690180049f8e0b7cb57bc4d856b.wav" 
Content-Length: 209324 
Content-Transfer-Encoding: binary 
Content-Type: audio/x-wav
Status HTTP404
La llamada identificada por el UUID no fue encontrada