API de cola de envíos de fax - Historial de revisiones

Dbautista en 12:24 2 jul 2021

2021-07-02T12:24:31Z

Lmoreno: /* Eliminar un envío pendiente */

2021-03-31T12:09:41Z

‎Eliminar un envío pendiente

Lmoreno en 12:09 31 mar 2021

2021-03-31T12:09:13Z

Cbedoya en 12:39 23 jul 2018

2018-07-23T12:39:53Z

Dbautista en 08:25 8 abr 2016

2016-04-08T08:25:30Z

Dbautista en 12:01 3 feb 2016

2016-02-03T12:01:06Z

Dbautista en 10:00 29 dic 2015

2015-12-29T10:00:34Z

Cbedoya en 11:08 24 dic 2015

2015-12-24T11:08:09Z

Cbedoya en 11:21 13 nov 2015

2015-11-13T11:21:26Z

Dbautista en 14:54 15 nov 2013

2013-11-15T14:54:24Z

@@ Línea 22: / Línea 22: @@
 La API de cola de envíos de fax '''se ofrece como un servicio web''', accesible mediante la URL:
-<pre>https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_faxes_cola?principal=xxxxxxxxx&pass=xxxxxxxx&fax=902009956</pre>
+ https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_faxes_cola?principal=xxxxxxxxx&pass=xxxxxxxx&fax=902009956<
 Para los clientes de Canarias, la URL es:
-<pre>https://cgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_faxes_cola?principal=xxxxxxxxx&pass=xxxxxxxx&fax=902009956</pre>
+ https://cgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_faxes_cola?principal=xxxxxxxxx&pass=xxxxxxxx&fax=902009956
@@ Línea 68: / Línea 68: @@
 Para eliminar un fax de la cola de envíos, a los parámetros obligatorios deberá añadirle la id y la plataforma del fax en cuestión. Por ejemplo, para el ejemplo anterior, deberíamos hacer la siguiente llamada:
-<pre>https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_faxes_cola?principal=xxxxxxxxx&pass=xxxxxxxx&fax=902009956&id=15&plataforma=56</pre>
+ https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_faxes_cola?principal=xxxxxxxxx&pass=xxxxxxxx&fax=902009956&id=15&plataforma=56
 ===Notas API de cola de envíos de fax===

@@ Línea 68: / Línea 68: @@
 Para eliminar un fax de la cola de envíos, a los parámetros obligatorios deberá añadirle la id y la plataforma del fax en cuestión. Por ejemplo, para el ejemplo anterior, deberíamos hacer la siguiente llamada:
-<pre>https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_faxes_cola?principal=xxxxxxxxx&pass=xxxxxxxx&fax=902009956&id=15&plataforma=56/pre>
+<pre>https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_faxes_cola?principal=xxxxxxxxx&pass=xxxxxxxx&fax=902009956&id=15&plataforma=56</pre>
 ===Notas API de cola de envíos de fax===

@@ Línea 22: / Línea 22: @@
 La API de cola de envíos de fax '''se ofrece como un servicio web''', accesible mediante la URL:
-  https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_faxes_cola?principal=xxxxxxxxx&pass=xxxxxxxx&fax=902009956
+<pre>https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_faxes_cola?principal=xxxxxxxxx&pass=xxxxxxxx&fax=902009956</pre>
 Para los clientes de Canarias, la URL es:
-  https://cgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_faxes_cola?principal=xxxxxxxxx&pass=xxxxxxxx&fax=902009956
+<pre>https://cgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_faxes_cola?principal=xxxxxxxxx&pass=xxxxxxxx&fax=902009956</pre>
@@ Línea 44: / Línea 44: @@
 La URL api_faxes_cola devuelve una respuesta text/xml con un conjunto de faxes en cola, con un elemento 'fax' por cada fax pendiente de envío (o enviándose):
+<pre>
   <?xml version="1.0" encoding="UTF-8" ?>
@@ Línea 60: / Línea 60: @@
     <numero_faxes>1</numero_faxes>
   </faxes_cola>
+</pre>
 Los campos 'plataforma' e 'id' identifican numéricamente al fax dentro de la cola de envíos. 'estado' puede ser 'Enviando' o 'Pendiente'. Los 'intentos_restantes' especifican el número de intentos que quedan frente a posibles errores (no hay fax al otro lado, hay un fallo en la comunicación del fax, etc.), mientras que 'comunicandos_restantes' indica el número de intentos que quedan frente a errores por "fax destinatario comunicando".
@@ Línea 68: / Línea 68: @@
 Para eliminar un fax de la cola de envíos, a los parámetros obligatorios deberá añadirle la id y la plataforma del fax en cuestión. Por ejemplo, para el ejemplo anterior, deberíamos hacer la siguiente llamada:
- https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_faxes_cola?principal=xxxxxxxxx&pass=xxxxxxxx&fax=902009956&id=15&plataforma=56
+<pre>https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_faxes_cola?principal=xxxxxxxxx&pass=xxxxxxxx&fax=902009956&id=15&plataforma=56/pre>

← Revisión anterior		Revisión del 12:39 23 jul 2018
Línea 11:		Línea 11:
	Con la API de cola de envíos de Fax, usted puede acceder a un '''listado de sus envíos actuales de fax vía HTTP''' sin necesidad de entrar en su cuenta. Esta herramienta es útil para integrar la cola de envíos de {{PRODUCTO}} con su base de datos, CRM, web, etc.		Con la API de cola de envíos de Fax, usted puede acceder a un '''listado de sus envíos actuales de fax vía HTTP''' sin necesidad de entrar en su cuenta. Esta herramienta es útil para integrar la cola de envíos de {{PRODUCTO}} con su base de datos, CRM, web, etc.

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

	===Activación API de cola de envíos de fax===		===Activación API de cola de envíos de fax===

@@ Línea 21: / Línea 21: @@
 La API de cola de envíos de fax '''se ofrece como un servicio web''', accesible mediante la URL:
-   https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_faxes_cola?principal=xxxxxxxxx&pin=1234&fax=902009956
+   https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_faxes_cola?principal=xxxxxxxxx&pass=xxxxxxxx&fax=902009956
 Para los clientes de Canarias, la URL es:
-   https://cgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_faxes_cola?principal=xxxxxxxxx&pin=1234&fax=902009956
+   https://cgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_faxes_cola?principal=xxxxxxxxx&pass=xxxxxxxx&fax=902009956
@@ Línea 31: / Línea 31: @@
 * 'principal' es el número de teléfono del cliente (con el que se dio de alta), también llamado "usuario de la cuenta {{PRODUCTO}}".
-* 'pin' es el PIN de la cuenta {{PRODUCTO}}.
+* 'pass' es la contraseña de la cuenta {{PRODUCTO}}.
 * 'fax' es el número de fax que ha realizado los envíos (su fax contratado con {{PRODUCTO}}).
@@ Línea 67: / Línea 67: @@
 Para eliminar un fax de la cola de envíos, a los parámetros obligatorios deberá añadirle la id y la plataforma del fax en cuestión. Por ejemplo, para el ejemplo anterior, deberíamos hacer la siguiente llamada:
-  https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_faxes_cola?principal=xxxxxxxxx&pin=1234&fax=902009956&id=15&plataforma=56
+  https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_faxes_cola?principal=xxxxxxxxx&pass=xxxxxxxx&fax=902009956&id=15&plataforma=56
 ===Notas API de cola de envíos de fax===
-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.
+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.

← Revisión anterior		Revisión del 12:01 3 feb 2016
Línea 14:		Línea 14:
	===Activación API de cola de envíos de fax===		===Activación API de cola de envíos de fax===

−	La API de cola de envíos de fax '''debe ser activada explícitamente en la web'''. El permiso es el mismo que tiene la [[API de buzones]]: en la pestaña de "Buzón" de cualquiera de los números de fax, sección "Opciones Avanzadas" (o en ~~Opciones~~ > Permisos de las APIs ~~y los servicios web~~), 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).	+	La API de cola de envíos de fax '''debe ser activada explícitamente en la web'''. El permiso es el mismo que tiene la [[API de buzones]]: en la pestaña de "Buzón" de cualquiera de los números de fax, sección "Opciones Avanzadas" (o 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).

← Revisión anterior		Revisión del 10:00 29 dic 2015
Línea 33:		Línea 33:
	* 'pin' es el PIN de la cuenta {{PRODUCTO}}.		* 'pin' es el PIN de la cuenta {{PRODUCTO}}.
	* 'fax' es el número de fax que ha realizado los envíos (su fax contratado con {{PRODUCTO}}).		* 'fax' es el número de fax que ha realizado los envíos (su fax contratado con {{PRODUCTO}}).
		+
		+
		+	===Parámetros opcionales===
		+
		+	* 'diferidos=1' para que también se listen los envíos de fax programados.

← Revisión anterior		Revisión del 11:08 24 dic 2015
Línea 80:		Línea 80:
	'''Indice'''		'''Indice'''

−	[[~~Portada~~]] >> [[Desarrolladores]] >> API de cola de envíos de fax.	+	[[Página principal]] >> [[Desarrolladores]] >> API de cola de envíos de fax.

@@ Línea 1: / Línea 1: @@
-===Descripción===
+{{#seo:
-===Activación===
+Con la API de cola de envíos de Fax, usted puede acceder a un '''listado de sus envíos actuales de fax vía HTTP''' sin necesidad de entrar en su cuenta. Esta herramienta es útil para integrar la cola de envíos de {{PRODUCTO}} con su base de datos, CRM, web, etc.
 La API de cola de envíos de fax '''debe ser activada explícitamente en la web'''. El permiso es el mismo que tiene la [[API de buzones]]: en la pestaña de "Buzón" de cualquiera de los números de fax, sección "Opciones Avanzadas" (o en Opciones > Permisos de las APIs y los servicios web), 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).
-===URL===
+===URL API de cola de envíos de fax===
 La API de cola de envíos de fax '''se ofrece como un servicio web''', accesible mediante la URL:
@@ Línea 27: / Línea 35: @@
-===Resultado===
+===Resultado API de cola de envíos de fax===
 La URL api_faxes_cola devuelve una respuesta text/xml con un conjunto de faxes en cola, con un elemento 'fax' por cada fax pendiente de envío (o enviándose):
@@ Línea 57: / Línea 65: @@
-===Notas===
+===Notas API de cola de envíos de fax===
 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.