Diferencia entre revisiones de «API de contactos»

Revisión del 12:36 17 feb 2012

ATENCIÓN: Este servicio se encuentra en desarrollo.

Este servicio web devuelve la lista de contactos (en XML) de una cuenta Telefácil.

Forma de uso

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.

@@ Línea 17: / Línea 17: @@
 Opcionalmente, se pueden pasar los siguientes parámetros:
-* 'eliminados', con cualquier valor (por ejemplo, eliminados=1), para que se listen los contactos eliminados en el último mes.
 * 'actualizado', con una fecha en [http://es.wikipedia.org/wiki/Tiempo_Unix 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 [http://es.wikipedia.org/wiki/Tiempo_Unix formato UNIX], se listan los contactos eliminados a partir de esa fecha (por ejemplo, eliminados=1329390208).
 ===Ejemplo===