API de contactos

ATENCIÓN: Este servicio se encuentra en desarrollo.

Este servicio web nos permite interactuar con los contactos de una cuenta Telefácil.

Forma de uso

Lista de contactos

Devuelve la lista de contactos (en XML).

La URL debe ser:

https://scgi.duocom.es/cgi-bin/telefacil2/apicontactos2?principal=xxxxxxxxx&pin=xxxx&accion=listar[&eliminados=1&actualizado=1329390208]

donde:

'principal' es su número de usuario de Telefácil.
'pin' es el PIN de la cuenta.
'accion' debe tener el valor 'listar'.

Opcionalmente, se pueden pasar los siguientes parámetros:

'actualizado', con una fecha en formato UNIX, para que se listen los contactos modificados a partir de dicha fecha. Por ejemplo, actualizado=1329390208.
'eliminados', con un valor mayor que 0 (por ejemplo, eliminados=1), para que se listen los contactos eliminados en el último mes. Si eliminados=1, se listan todos los eliminados (en el último mes); si eliminados tiene un valor en formato UNIX, se listan los contactos eliminados a partir de esa fecha (por ejemplo, eliminados=1329390208).

Ejemplo

Tenga presente que, aunque la aplicación web es accesible mediante una URL, no debe poner nunca enlaces a esta aplicación directamente en el código fuente de sus páginas web, ya que sus visitantes podrían descubrir datos sensibles como su número de usuario y su pin simplemente mirando el código HTML.

La aplicación web debe ser llamada siempre desde el servidor, usando para ello alguna de las librerías que permite llamadas a servicios HTTPS.

He aquí un ejemplo en PHP usando cURL, cortesía de tuayudainformatica.com:

<?php
  $usuario = '666111666';
  $pin = '0000';

  $curl = curl_init("https://scgi.duocom.es/cgi-bin/telefacil2/apicontactos2?
                     principal=${usuario}&pin=${pin}&accion=listar"); // LLAMADA DE LA URL
  curl_setopt($curl, CURLOPT_HEADER, false);  // PARA EVITAR DEVOLUCION DE CABEZERAS HTTP
  curl_setopt($curl, CURLOPT_TIMEOUT, 5);     // TIEMPO DE ESPERA   
  $output = curl_exec($curl);                 // EJECUTAMOS LA LLAMADA
  curl_close($curl);
  $output = substr($output, 0, 1);            // XML
?>

Indice

Portada >> Desarrolladores >> Servicio web de contactos.