API de contactos - Historial de revisiones

Dcruz: /* Insertar un contacto */

2025-06-26T11:43:09Z

‎Insertar un contacto

Dbautista en 12:28 2 jul 2021

2021-07-02T12:28:47Z

Mostrar los cambios

Lmoreno: /* Gestión de la foto del contacto */

2021-03-31T12:19:04Z

‎Gestión de la foto del contacto

Lmoreno: /* Lista de grupos de contactos */

2021-03-31T12:18:25Z

‎Lista de grupos de contactos

Lmoreno en 12:17 31 mar 2021

2021-03-31T12:17:51Z

Mostrar los cambios

Cbedoya en 12:40 23 jul 2018

2018-07-23T12:40:05Z

Lmoreno en 11:42 11 abr 2017

2017-04-11T11:42:47Z

Cbedoya en 16:08 19 dic 2016

2016-12-19T16:08:30Z

Dbautista en 12:40 18 nov 2016

2016-11-18T12:40:45Z

Dbautista en 12:19 11 ago 2016

2016-08-11T12:19:11Z

@@ Línea 107: / Línea 107: @@
 La URL debe ser:
-  https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/apicontactos2?principal=xxxxxxxxx&pass=xxxxxxxx&accion=insertar[&nombre=Juan&...]
+  https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/apicontactos2?principal=xxxxxxxxx&pass=xxxxxxxx&accion=insertar&nombre=Juan&...
 donde:
@@ Línea 134: / Línea 134: @@
 Opcionalmente, se puede enviar el campo "listar=1" y, si no hubo error, en la respuesta vendrá el contacto insertado. También opcionalmente se puede mandar un campo "grupo=NOMBRE" (donde NOMBRE es el nombre de un grupo preexistente) y el contacto se asignará a ese grupo nada más ser creado.
 ===Actualizar un contacto===

@@ Línea 292: / Línea 292: @@
 Si el contacto tiene una foto, cuando se liste aparecerá un campo "foto":
+<pre>
   <foto>
     <original>https://scgi.duocom.es/cgi-bin/telefacil2/apicontactos2?accion=foto&id=1234</original>
@@ Línea 298: / Línea 298: @@
     <thumbnail_24>https://scgi.duocom.es/cgi-bin/telefacil2/apicontactos2?accion=foto&id=1234&size=24</thumbnail_24>
   </foto>
+</pre>
 Para bajar dicha foto (nótese que también se ofertan thumbnails a 120x120 y a 24x24) simplemente habrá que usar la URL que se provee añadiéndole los campos "principal" y "pass" (o "usuario_voip" y "password_voip"):
@@ Línea 312: / Línea 312: @@
 <pre>https://scgi.duocom.es/cgi-bin/telefacil2/apicontactos2?accion=eliminar_foto&id=1234&principal=999888777&pass=xxxxxxxx</pre>
 ===Tipos de datos===

@@ Línea 73: / Línea 73: @@
 Los usuarios de Canarias deben usar la siguiente URL alternativa:
- https://cgi.duocom.es/cgi-bin/{{DIR_CGI}}/apicontactos2?principal=xxxxxxxxx&pass=xxxxxxxx&accion=listar_grupos
+<pre>https://cgi.duocom.es/cgi-bin/{{DIR_CGI}}/apicontactos2?principal=xxxxxxxxx&pass=xxxxxxxx&accion=listar_grupos</pre>
 Los parámetros son iguales que en el caso de listar contactos:
@@ Línea 84: / Línea 84: @@
 <pre>https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/apicontactos2?usuario_voip=902955955.1234@{{DOMINIO}}&password_voip=SECRET&accion=listar_grupos</pre>
 ===Seleccionar un contacto por su ID===

← Revisión anterior		Revisión del 12:40 23 jul 2018
Línea 11:		Línea 11:

	Este servicio web nos permite interactuar con los contactos de una cuenta {{PRODUCTO}}.		Este servicio web nos permite interactuar con los contactos de una cuenta {{PRODUCTO}}.
		+
		+	Si no sabe lo que es una API lea [[que es una api\|¿Qué son las APIs de {{PRODUCTO}}?]]

	===Activación===		===Activación===

@@ Línea 40: / Línea 40: @@
 Opcionalmente, se pueden pasar los siguientes parámetros:
-* 'actualizado', con una fecha en [http://es.wikipedia.org/wiki/Tiempo_Unix formato UNIX], para que se listen sólo los contactos modificados a partir de dicha fecha. Por ejemplo, actualizado=1329390208.
+* 'actualizado', con una fecha en [https://es.wikipedia.org/wiki/Tiempo_Unix formato UNIX], para que se listen sólo 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). Si se pasa un valor mayor que 0, la lista de contactos eliminados se añade a la lista de contactos normales. Por defecto, no se muestran los contactos eliminados.
+* '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 [https://es.wikipedia.org/wiki/Tiempo_Unix formato UNIX], se listan los contactos eliminados a partir de esa fecha (por ejemplo, eliminados=1329390208). Si se pasa un valor mayor que 0, la lista de contactos eliminados se añade a la lista de contactos normales. Por defecto, no se muestran los contactos eliminados.
 * '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).
 * 'busqueda', con el contenido de alguno de los campos del contacto, para hacer una búsqueda de los contactos que tienen ese valor.
@@ Línea 493: / Línea 493: @@
 ===Respuesta del servicio===
-El servicio web retorna todas las respuestas en formato [http://es.wikipedia.org/wiki/Extensible_Markup_Language XML]. Todas las respuestas están encerradas en la raíz 'contactos', y contiene siempre un campo 'error' que será 0 si el comando o petición enviado al servidor se ejecutó con éxito, o 1 si hubo algún error, en cuyo caso habrá también un campo 'msgerr' que explica dicho error.
+El servicio web retorna todas las respuestas en formato [https://es.wikipedia.org/wiki/Extensible_Markup_Language XML]. Todas las respuestas están encerradas en la raíz 'contactos', y contiene siempre un campo 'error' que será 0 si el comando o petición enviado al servidor se ejecutó con éxito, o 1 si hubo algún error, en cuyo caso habrá también un campo 'msgerr' que explica dicho error.
 Por ejemplo, una respuesta afirmativa sería:

@@ Línea 2: / Línea 2: @@
 |title= Contactos {{PROD_TILDE}}.
 |titlemode=append
-|keywords=numero virtual, telefono fijo, numero de telefono virtual, API, linea telefonica virtual, segunda linea, apple, sincronizacion, numero fijo en el movil, contactos
+|keywords=contactos a domicilio, numero virtual, telefono fijo, numero de telefono virtual, API, linea telefonica virtual, segunda linea, apple, sincronizacion, numero fijo en el movil, contactos
 |description=Las aplicaciones de los números virtuales pueden sincronizarse con la agenda de contactos de cualquier dispositivo movil y con las APIs.
 }}
@@ Línea 14: / Línea 14: @@
 ===Activación===
-Este servicio '''debe activarse explícitamente dentro de la web''', en Contactos > API (o en Desarrolladores > Permisos de las APIs y los servicios web). En esa sección también se pueden restringir las direcciones IP desde las que se puede llamar a esta aplicación web. Si usted tiene una dirección IP fija por favor introdúzcala aquí, aumenta la seguridad.
+Este servicio '''debe activarse explícitamente dentro de la web''', en Contactos > API (o en Desarrolladores > Permisos de las APIs y los servicios web). En esa sección también se pueden restringir las direcciones IP desde las que se puede llamar a esta aplicación web. Si usted tiene una dirección IP fija por favor debe introducirla aquí,  para aumentar la seguridad.

@@ Línea 43: / Línea 43: @@
 * '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). Si se pasa un valor mayor que 0, la lista de contactos eliminados se añade a la lista de contactos normales. Por defecto, no se muestran los contactos eliminados.
 * '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).
 En vez de enviar el par principal/pass se puede enviar la dupla usuario_voip/password_voip:
@@ Línea 90: / Línea 91: @@
 Obviamente, la respuesta será un solo contacto (o ninguno, si la ID es incorrecta).

← Revisión anterior		Revisión del 12:19 11 ago 2016
Línea 122:		Línea 122:
	&num_telefonos=2&telefono1=928999444&custom_telefono1=MiTipoPropio&telefono2=911222333&tipo_telefono2=0&num_emails=1&email1=micorreo@hotmail.com&custom_email1=MiTipoPropioEmail		&num_telefonos=2&telefono1=928999444&custom_telefono1=MiTipoPropio&telefono2=911222333&tipo_telefono2=0&num_emails=1&email1=micorreo@hotmail.com&custom_email1=MiTipoPropioEmail

−	Opcionalmente, se puede enviar el campo "listar=1" y, si no hubo error, en la respuesta vendrá el contacto insertado.	+	Opcionalmente, se puede enviar el campo "listar=1" y, si no hubo error, en la respuesta vendrá el contacto insertado. También opcionalmente se puede mandar un campo "grupo=NOMBRE" (donde NOMBRE es el nombre de un grupo preexistente) y el contacto se asignará a ese grupo nada más ser creado.