Diferencia entre revisiones de «API de contactos»
| Línea 18: | Línea 18: | ||
* 'eliminados', para que se listen los contactos eliminados en el último mes. | * 'eliminados', para que se listen los contactos eliminados en el último mes. | ||
| + | |||
| + | ===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/{{DIR_CGI}}/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 | ||
| + | ?> | ||
Revisión del 15:08 15 feb 2012
ATENCIÓN: En desarrollo.
Devuelve la lista de contactos en XML.
Forma de uso
La URL debe ser:
https://scgi.duocom.es/cgi-bin/telefacil2/apicontactos2?principal=xxxxxxxxx&pin=xxxx&accion=listar[&eliminados=1]
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:
- 'eliminados', para que se listen los contactos eliminados en el último mes.
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.