API de filtros - Historial de revisiones

Dbautista en 12:11 2 jul 2021

2021-07-02T12:11:53Z

Lmoreno: /* URL de API de filtros */

2021-03-31T11:42:12Z

‎URL de API de filtros

Lmoreno: /* Ejemplo de la API de filtros */

2020-05-28T09:19:08Z

‎Ejemplo de la API de filtros

Lmoreno: /* Eliminar todos los filtros */

2020-05-28T09:18:04Z

‎Eliminar todos los filtros

Lmoreno: /* Eliminar un filtro */

2020-05-28T09:17:41Z

‎Eliminar un filtro

Lmoreno: /* Insertar un nuevo filtro */

2020-05-28T09:17:11Z

‎Insertar un nuevo filtro

Lmoreno: /* Leer los filtros actuales */

2020-05-28T09:15:29Z

‎Leer los filtros actuales

Cbedoya en 12:37 23 jul 2018

2018-07-23T12:37:23Z

Dbautista en 08:59 4 jul 2016

2016-07-04T08:59:51Z

Dbautista en 12:42 23 may 2016

2016-05-23T12:42:34Z

@@ Línea 12: / Línea 12: @@
 La API de filtros se ofrece como un servicio web, accesible mediante la URL:
-<pre>https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_filtros?principal=xxxxxxxxx&pass=xxxxxxxx&nv=xxxxxxxxx</pre>
+ https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_filtros?principal=xxxxxxxxx&pass=xxxxxxxx&nv=xxxxxxxxx
 Para los clientes de Canarias, la URL es:
-<pre>https://cgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_filtros?principal=xxxxxxxxx&pass=xxxxxxxx&nv=xxxxxxxxx</pre>
+ https://cgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_filtros?principal=xxxxxxxxx&pass=xxxxxxxx&nv=xxxxxxxxx
 Para acceder a esta API hay que tener dado de alta un número virtual, un número de centralita virtual o un número de fax. En Desarrolladores > Permisos de las APIs se puede activar esta API (por defecto se encuentra desactivada) y restringir su uso según la IP de acceso a la misma (esto es aconsejable para aumentar la seguridad si se tiene una dirección IP fija).
@@ Línea 39: / Línea 39: @@
 Para leer los filtros que actualmente están espeficicados, hay que llamar a la URL de la API sin ninguna acción. Por ejemplo, para un número virtual:
-<pre> https://scgi.duocom.es/cgi-bin/telefacil2/api_filtros?principal=999888777&pass=1111&nv=902009955</pre>
+ https://scgi.duocom.es/cgi-bin/telefacil2/api_filtros?principal=999888777&pass=1111&nv=902009955
 Para una extensión:
-<pre>https://scgi.duocom.es/cgi-bin/telefacil2/api_filtros?principal=999888777&pass=1111&ext=1234</pre>
+ https://scgi.duocom.es/cgi-bin/telefacil2/api_filtros?principal=999888777&pass=1111&ext=1234
 La API devolverá un XML de este tipo:
@@ Línea 91: / Línea 91: @@
 Ejemplo:
-<pre>https://scgi.duocom.es/cgi-bin/telefacil2/api_filtros?principal=666555444&pass=2211&ext=1253&accion=insertar&telefono=912345678&accion_filtro=buzon&comentario=TEST</pre>
+ https://scgi.duocom.es/cgi-bin/telefacil2/api_filtros?principal=666555444&pass=2211&ext=1253&accion=insertar&telefono=912345678&accion_filtro=buzon&comentario=TEST
 Si todo es correcto, se listarán los filtros después de la inserción.
@@ Línea 104: / Línea 104: @@
 Ejemplo:
-<pre>https://scgi.duocom.es/cgi-bin/telefacil2/api_filtros?principal=666555444&pass=2211&ext=1253&accion=eliminar&id=2</pre>
+ https://scgi.duocom.es/cgi-bin/telefacil2/api_filtros?principal=666555444&pass=2211&ext=1253&accion=eliminar&id=2
 Si todo es correcto, se listarán los filtros después del borrado.
@@ Línea 112: / Línea 112: @@
 Para eliminar todos los filtros pasamos accion=eliminar_todo. Por ejemplo:
-<pre>https://scgi.duocom.es/cgi-bin/telefacil2/api_filtros?principal=666555444&pass=2211&ext=1253&accion=eliminar_todo</pre>
+ https://scgi.duocom.es/cgi-bin/telefacil2/api_filtros?principal=666555444&pass=2211&ext=1253&accion=eliminar_todo
 Si todo es correcto, se listarán los filtros después del borrado total.

@@ Línea 12: / Línea 12: @@
 La API de filtros se ofrece como un servicio web, accesible mediante la URL:
- https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_filtros?principal=xxxxxxxxx&pass=xxxxxxxx&nv=xxxxxxxxx
+<pre>https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_filtros?principal=xxxxxxxxx&pass=xxxxxxxx&nv=xxxxxxxxx</pre>
 Para los clientes de Canarias, la URL es:
- https://cgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_filtros?principal=xxxxxxxxx&pass=xxxxxxxx&nv=xxxxxxxxx
+<pre>https://cgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_filtros?principal=xxxxxxxxx&pass=xxxxxxxx&nv=xxxxxxxxx</pre>
 Para acceder a esta API hay que tener dado de alta un número virtual, un número de centralita virtual o un número de fax. En Desarrolladores > Permisos de las APIs se puede activar esta API (por defecto se encuentra desactivada) y restringir su uso según la IP de acceso a la misma (esto es aconsejable para aumentar la seguridad si se tiene una dirección IP fija).
@@ Línea 43: / Línea 43: @@
 Para una extensión:
- <pre>https://scgi.duocom.es/cgi-bin/telefacil2/api_filtros?principal=999888777&pass=1111&ext=1234</pre>
+<pre>https://scgi.duocom.es/cgi-bin/telefacil2/api_filtros?principal=999888777&pass=1111&ext=1234</pre>
 La API devolverá un XML de este tipo:

@@ Línea 123: / Línea 123: @@
 He aquí un ejemplo en PHP usando cURL:
+<pre>
   <?php
     $usuario = '666111666';
@@ Línea 136: / Línea 136: @@
     // en $output esta la respuesta XML
   ?>
+</pre>
 ----

@@ Línea 112: / Línea 112: @@
 Para eliminar todos los filtros pasamos accion=eliminar_todo. Por ejemplo:
- https://scgi.duocom.es/cgi-bin/telefacil2/api_filtros?principal=666555444&pass=2211&ext=1253&accion=eliminar_todo
+<pre>https://scgi.duocom.es/cgi-bin/telefacil2/api_filtros?principal=666555444&pass=2211&ext=1253&accion=eliminar_todo</pre>
 Si todo es correcto, se listarán los filtros después del borrado total.

@@ Línea 104: / Línea 104: @@
 Ejemplo:
- https://scgi.duocom.es/cgi-bin/telefacil2/api_filtros?principal=666555444&pass=2211&ext=1253&accion=eliminar&id=2
+<pre>https://scgi.duocom.es/cgi-bin/telefacil2/api_filtros?principal=666555444&pass=2211&ext=1253&accion=eliminar&id=2</pre>
 Si todo es correcto, se listarán los filtros después del borrado.

← Revisión anterior		Revisión del 12:37 23 jul 2018
Línea 7:		Línea 7:

	==URL de API de filtros==		==URL de API de filtros==
		+
		+	Si no sabe lo que es una API lea [[que es una api\|¿Qué son las APIs de {{PRODUCTO}}?]]

	La API de filtros se ofrece como un servicio web, accesible mediante la URL:		La API de filtros se ofrece como un servicio web, accesible mediante la URL:

@@ Línea 24: / Línea 24: @@
 * Además, hace falta especificar:
 ** o bien 'nv' como el número virtual al que se quieren consultar o modificar los filtros.
 ** o bien 'ext' como la extensión a la que se quieren consultar o modificar los filtros.
 ** o bien 'fax' como el número de fax al que se quieren consultar o modificar los filtros.
 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 contraseña simplemente mirando el código HTML.

← Revisión anterior		Revisión del 12:42 23 may 2016
Línea 111:		Línea 111:

	Si todo es correcto, se listarán los filtros después del borrado total.		Si todo es correcto, se listarán los filtros después del borrado total.
		+
		+	===Ejemplo de la API de filtros===
		+
		+	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 contraseña 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:
		+
		+	<?php
		+	$usuario = '666111666';
		+	$pass = 'MiClaveSecreta';
		+	$nv = '911010000';
		+
		+	$curl = curl_init("https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_filtros?principal=${usuario}&pass=${pass}&nv=${nv}");
		+	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);
		+	// en $output esta la respuesta XML
		+	?>
		+

	----		----