API de desvíos

URL

La API de desvíos se ofrece como un servicio web, accesible mediante la URL:

 https://scgi.duocom.es/cgi-bin/telefacil2/api_desvios?principal=xxxxxxxxx&pin=1234&nv=xxxxxxxxx

Para los clientes de Canarias, la URL es:

 https://cgi.duocom.es/cgi-bin/telefacil2/api_desvios?principal=xxxxxxxxx&pin=1234&nv=xxxxxxxxx

Parámetros obligatorios

'principal' es el número de teléfono del cliente (con el que se dio de alta), también llamado "usuario de la cuenta Telefácil".
'pin' es el PIN de la cuenta Telefácil.
Además, hace falta especificar:
- o bien 'nv' como el número virtual al que se quieren modificar los desvíos.
- o bien 'ext' como la extensión a la que se quieren modificar los desvíos.

Leer los desvíos actuales

Ante cualquier petición, ya sea de lectura o de modificación de desvíos, el sistema ofrecerá los desvíos actuales del número virtual o extensión especificada. Por ejemplo, si queremos leer los desvíos del número virtual 902955955 de la cuenta 911922933, la petición sería:

 https://scgi.duocom.es/cgi-bin/telefacil2/api_desvios?principal=911922933&pin=0000&nv=902955955

En el caso de querer los desvíos de la extensión 2345, tendríamos que crear la siguiente petición:

 https://scgi.duocom.es/cgi-bin/telefacil2/api_desvios?principal=911922933&pin=0000&ext=2345

El sistema ofrecerá una respuesta en texto plano de la siguiente forma:

 OK
 [por defecto] => #1: desvio1 (esp1) #2: desvio2 (esp2) #3: desvio3 (esp3) #4: desvio4 (esp4) #5: desvio5 (esp5)
 HH:MM-HH:MM lmxvsdf => #1: desvio1 (esp1) #2: desvio2 (esp2) #3: desvio3 (esp3) #4: desvio4 (esp4) #5: desvio5 (esp5)
 HH:MM-HH:MM lmxvsdf => #1: desvio1 (esp1) #2: desvio2 (esp2) #3: desvio3 (esp3) #4: desvio4 (esp4) #5: desvio5 (esp5)
 ...

Primero se lista el resultado de la operación ('OK' si todo fue bien). Después se lista el desvío por defecto, con cada uno de los desvíos configurados (desvio1..desvio5). Entre paréntesis se pone el tiempo de espera de cada desvío. No tienen por qué aparecer los 5 desvíos: si sólo hay dos desvíos, aparecerán en la línea desvio1 y desvio2. En el caso de que no hubiera desvíos, la línea aparecería como:

 [por defecto] =>

Por último, se listan los desvíos por horario (si los hubiere), indicando primero el horario y los días del mismo (l: lunes, m: martes, x: miércoles, j: jueves, v: viernes, s: sábados, d: domingos).

Por ejemplo:

 OK
 [por defecto] => #1: 911922933@telefacil.com (0) #2: 655644633 (25) 
 12:00-13:00 lmxjvsdf => #1: 911922933@telefacil.com (0) #2: 933844755 (34)