API de envío de faxes - Historial de revisiones

Dcruz: /* Ejemplo */

2022-03-11T09:31:21Z

‎Ejemplo

Dcruz: /* Ejemplo */

2022-03-11T09:29:27Z

‎Ejemplo

Dbautista en 12:22 2 jul 2021

2021-07-02T12:22:10Z

Lmoreno en 08:31 2 jul 2021

2021-07-02T08:31:32Z

Lmoreno: /* Ejemplo */

2021-03-31T12:06:09Z

‎Ejemplo

Lmoreno: /* Forma de uso */

2021-03-31T12:05:27Z

‎Forma de uso

Lmoreno en 12:04 31 mar 2021

2021-03-31T12:04:17Z

Cbedoya: /* Lista de errores */

2018-12-04T10:59:42Z

‎Lista de errores

Cbedoya en 12:39 23 jul 2018

2018-07-23T12:39:30Z

Dbautista en 08:24 8 abr 2016

2016-04-08T08:24:03Z

@@ Línea 103: / Línea 103: @@
   ?>
 </pre>
 <span style="visibility:hidden">  $data = array('principal' => $principal, 'pass' => $pass, 'remitente' => $remitente, 'destino' => $destino, 'tipo_fichero' => $tipo_fichero, 'fichero' => '@' . $file);</span>

@@ Línea 88: / Línea 88: @@
     $tipo_fichero = 'pdf';
     $file = 'C:\\temp\\fichero.pdf';
-−
     $ch = curl_init();
@@ Línea 95: / Línea 97: @@
     curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
     curl_setopt($ch, CURLOPT_POST, 1);
-    $data = array('principal' => $principal, 'pass' => $pass, 'remitente' => $remitente, 'destino' => $destino, 'tipo_fichero' => $tipo_fichero, 'fichero' => '@' . $file);
+    $data = array('principal' => $principal, 'pass' => $pass, 'remitente' => $remitente, 'destino' => $destino, 'tipo_fichero' => $tipo_fichero, 'fichero' => $cfile);
     curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
     $output = curl_exec ($ch);
@@ Línea 101: / Línea 103: @@
   ?>
 </pre>
 ===Lista de errores===

@@ Línea 22: / Línea 22: @@
 La URL es:
-<pre>https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_enviar_fax</pre>
+ https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_enviar_fax
 Para los clientes de Canarias sería:
-<pre>https://cgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_enviar_fax</pre>
+ https://cgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_enviar_fax
 A esta URL hay que pasarle los siguientes parámetros '''en forma "multipart/form-data"''':

@@ Línea 1: / Línea 1: @@
 {{#seo:
-|title=Fax online
+|title=API para faxear mediante servicio web
 |titlemode=append
-|keywords=servicio web, envio faxes, fax virtual, API, integracion api, enviar fax desde pc, fax online, numero de fax, impresora fax, fax por email
+|keywords=fax web service api, faxear, servicio web fax, API, integracion api fax, mensajes de fax, fax en linea
-|description=Servicio para envíos de faxes desde la web automatizados. Integre su Fax Virtual con las APIs de {{PRODUCTO}}.
+|description=Servicio web para faxear en línea de forma automatizada. Integre su fax virtual con las APIs de {{PRODUCTO}}.
 }}
-===Descripción API de envío de faxes===
+===Descripción API de fax===
-Con este servicio web, usted puede automatizar el envío de faxes vía {{PRODUCTO}} desde su infraestructura web. Este servicio replica la funcionalidad descrita en [[Enviar faxes desde la web]].
+Con este servicio web, usted puede automatizar los envíos de mensajes de fax vía {{PRODUCTO}} desde su infraestructura web. Este servicio replica la funcionalidad descrita en [[Enviar faxes desde la web]].
-Recuerde que también puede usar [[Envío de faxes vía SMTP]] para automatizar los envíos de faxes.
+Recuerde que también puede usar [[Envío de faxes vía SMTP]] para automatizar este proceso.
 Si no sabe lo que es una API lea [[que es una api|¿Qué son las APIs de {{PRODUCTO}}?]]
-===Activación API de envío de faxes===
+===Activación API Fax===
 Este servicio '''debe activarse explícitamente dentro de la web''', en Oficina Virtual > Fax 9XXXXXXXX > Enviar Fax > Servicio web para integración (abajo del todo). O bien 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.
@@ Línea 52: / Línea 52: @@
 ===Formulario de ejemplo===
-Aquí hay un ejemplo de un formulario HTML que hace uso de la API de envío de faxes:
+Aquí hay un ejemplo de un formulario HTML que hace uso de la API para el envío de mensajes de fax en línea:
 <pre>
   <html>
   <head>
-  <title>Prueba de API de envio de faxes</title>
+  <title>Prueba de API</title>
   </head>
   <body>

@@ Línea 100: / Línea 100: @@
     curl_close ($ch);
   ?>
-<pre>
+</pre>
 ===Lista de errores===

@@ Línea 108: / Línea 108: @@
 * "'xxxyyyzzz' no es un numero de fax": el número especificado no es un fax.
 * "El fichero de entrada no se puede procesar": el fichero enviado no parece un PDF o un DOC correcto.
 ----

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

	Recuerde que también puede usar [[Envío de faxes vía SMTP]] para automatizar los envíos de faxes.		Recuerde que también puede usar [[Envío de faxes vía SMTP]] para automatizar los envíos de faxes.
		+
		+	Si no sabe lo que es una API lea [[que es una api\|¿Qué son las APIs de {{PRODUCTO}}?]]

	===Activación API de envío de faxes===		===Activación API de envío de faxes===

@@ Línea 29: / Línea 29: @@
 * 'principal' es su número de usuario de {{PRODUCTO}}.
-* 'pin' es el PIN de la cuenta.
+* 'pass' es la contraseña de la cuenta.
 * 'remitente' es el número de fax contratado en {{PRODUCTO}} desde el que quiere realizar el envío.
 * 'tipo_fichero' puede ser 'pdf' para archivos PDF o 'doc' para archivos Word, Excel, Powerpoint u OpenDocument.
@@ Línea 46: / Línea 46: @@
 ** 'comentarios': comentarios del Fax.
 * 'referencia=xxxxxxxx': una referencia que puede ser de hasta 17 caracteres, y sirve para seguirle la pista a su envío, puesto que en el cuerpo del e-mail de confirmación (en el caso de que lo haya activado) le vendrá la misma referencia que usted haya escrito. También saldrá en la [[API de registro de faxes enviados]].
-* 'grupos=1': esto indica que el remitente del fax es de uno de los [[Grupos de fax]] y que el PIN enviado es el de ese grupo (no el pin de la cuenta).
+* 'grupos=1': esto indica que el remitente del fax es de uno de los [[Grupos de fax]] y que el PIN enviado es el de ese grupo (no la contraseña de la cuenta).
 ===Formulario de ejemplo===
@@ Línea 60: / Línea 60: @@
   <form name="envio" enctype="multipart/form-data" method="POST" action="https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_enviar_fax">
   <input type="hidden" name="principal" value="xxxxxxxxx">
-  <input type="hidden" name="pin" value="xxxx">
+  <input type="hidden" name="pass" value="xxxxxxxx">
   <input type="hidden" name="remitente" value="xxxxxxxxx">
   <input type="hidden" name="tipo_fichero" value="pdf">
@@ Línea 73: / Línea 73: @@
 ====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.
+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.
@@ Línea 81: / Línea 81: @@
   <?php
     $principal = '666111666';
-    $pin = '0000';
+    $pass = 'MiClaveSecreta';
     $remitente = '911000222';
     $destino = '930000000,987666555,928400956';
@@ Línea 93: / Línea 93: @@
     curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
     curl_setopt($ch, CURLOPT_POST, 1);
-    $data = array('principal' => $principal, 'pin' => $pin, 'remitente' => $remitente, 'destino' => $destino, 'tipo_fichero' => $tipo_fichero, 'fichero' => '@' . $file);
+    $data = array('principal' => $principal, 'pass' => $pass, 'remitente' => $remitente, 'destino' => $destino, 'tipo_fichero' => $tipo_fichero, 'fichero' => '@' . $file);
     curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
     $output = curl_exec ($ch);
@@ Línea 101: / Línea 101: @@
 ===Lista de errores===
-* "Login incorrecto": usuario y/o pin incorrectos.
+* "Login incorrecto": usuario y/o contraseña incorrectos.
 * "API no activa": no se ha activado la API en la página web.
 * "API no activa para esta IP": la API está activa, pero la IP que hace la petición no está dentro de las IPs permitidas.