API

A grandes rasgos, la API intentará seguir el formato REST.

Al inicio del projecto se definirá una URL bajo HTTPS a la que atacar y será del estilo:

https://pbx.centralita.com/app/api/call_data.php?....

Las peticiones de recogida de datos se harán GET y las de modificaciones por POST a no ser que se especifique lo contrario. Las respuestas serán siempre en formato JSON.

Autenticación

Sarenet debe proveedor de un usuario y contraseña/clave api válida para poder trabajar. Estos datos tendrán que ir en todas las peticiones en uno de estos dos formatos (en la documentación se utilizará indistintamente uno de los dos):

username=apiuser&password=fkG_FZ45M_uLXCS
key=xxxxxxxx

¡Ojo!

Mediante esta API es posible generar llamadas con coste, bajo ningún concepto hay que pasar o almacenar la clave de forma no segura y/o compartirla con terceros.

Centralita

La centralita tiene internamente dos perfiles: internal y external.

El internal es el que se encarga de hablar con las extensiones y el external con los gateways (proveedores, liceas, etc...).

Por lo tanto, cuando una extensión llama a un número, bien directamente o bien a través del click2call, la centralita genera dos llamadas (o una llamada con dos patas). Esta llamada estará identificada con un UUID.