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&grupo=Trabajo]
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).
- 'grupo', con el nombre de un grupo de contactos, para que se listen sólo los contactos que pertenecen a dicho grupo (esta condición también afecta a los contactos eliminados).
Eliminar un contacto
La URL debe ser:
donde:
- 'principal' es su número de usuario de Telefácil.
- 'pin' es el PIN de la cuenta.
- 'accion' debe tener el valor 'eliminar'.
- 'id' es el identificador del contacto.
Ejemplo en PHP
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.