API de registro de SMS enviados - Historial de revisiones

Dbautista en 12:21 2 jul 2021

2021-07-02T12:21:06Z

Lmoreno en 12:02 31 mar 2021

2021-03-31T12:02:41Z

Cbedoya en 12:39 23 jul 2018

2018-07-23T12:39:19Z

Dbautista en 08:22 8 abr 2016

2016-04-08T08:22:43Z

Cbedoya en 10:48 24 dic 2015

2015-12-24T10:48:44Z

Cbedoya en 13:50 16 nov 2015

2015-11-16T13:50:40Z

Dbautista en 12:50 6 may 2015

2015-05-06T12:50:28Z

Dbautista en 12:59 15 may 2012

2012-05-15T12:59:52Z

Dbautista: Página nueva: ===Descripción=== Con la API de registro de SMS enviados, usted puede acceder a un '''listado de sus envíos de SMS vía HTTP''' sin necesidad de entrar en su cuenta. Esta herramien...

2012-05-11T11:10:09Z

Página nueva: ===Descripción=== Con la API de registro de SMS enviados, usted puede acceder a un '''listado de sus envíos de SMS vía HTTP''' sin necesidad de entrar en su cuenta. Esta herramien...

Página nueva

===Descripción===

Con la API de registro de SMS enviados, usted puede acceder a un '''listado de sus envíos de SMS vía HTTP''' sin necesidad de entrar en su cuenta. Esta herramienta es útil para integrar el reporte de envíos de {{PRODUCTO}} con su base de datos, CRM, web, etc.

===URL===

La API de registro de SMS enviados '''se ofrece como un servicio web''', accesible mediante la URL:

https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_sms_enviados?principal=xxxxxxxxx&pin=1234

Para los clientes de Canarias, la URL es:

https://cgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_sms_enviados?principal=xxxxxxxxx&pin=1234

===Parámetros obligatorios===

* '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}}.

===Parámetros opcionales===

* 'finicio' indica la fecha de inicio desde la que se quieren consultar los consumos. Debe estar en formato DD-MM-YYYY. Por defecto, toma el valor del día de hoy.
* 'ffinal' indica la fecha final hasta la que se quieren consultar los consumos. Debe estar en formato DD-MM-YYYY. Por defecto, toma el valor del día de hoy.
* 'tipo_salida': puede ser 'text' (por defecto; para salida tipo texto plano), 'html' (para salida tipo tabla de HTML) o 'xml' (para salida tipo XML).

===Resultado===

La URL api_sms_enviados devuelve una respuesta text/plain (o text/xml o text/html si se especifica con el parámetro 'tipo_salida'), con una serie de líneas de texto con los siguientes campos:

* fecha: fecha del envío (DD/MM/YYYY).
* hora: hora en que empezó el envío (HH:MM:SS).
* texto: texto del SMS.
* destinatario: el número al que se envió el fax.
* nombre: nombre del destinatario (si se conoce).
* pais: país del destinatario.
* recibido: fecha y hora de la recepción del SMS en el terminal del destinatario (vacío si no se ha recibido).
* confirmado: fecha y hora de la confirmación vía URL del SMS por parte del destinatario (vacío si no se ha confirmado).

Si la respuesta se pide en XML, se devolverá un conjunto de SMS enviados, con un elemento 'envio' por cada envío realizado:

<?xml version="1.0" encoding="UTF-8" ?>

<sms_enviados>
<error>0</error>
<envio>
<fecha>11/04/2012</fecha>
<hora>10:50:47</hora>
<destinatario>612345678</destinatario>
<nombre>RITA </nombre>
<pais><![CDATA[Spain - Mobile]]></pais>
<texto><![CDATA[Estoy probando el servicio de sms desde mi identificador de llamadas]]></texto>
<recibido>11/04/2012 10:51:11</recibido>
<confirmado></confirmado>
</envio>
</sms_enviados>

Si la respuesta se pide en HTML, se devolverá una tabla con id y class "tabla_sms_enviados". Posteriormente, le puede aplicar el estilo CSS que desee.

===Notas===

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.

----

----

'''Indice'''

[[Portada]] >> [[Desarrolladores]] >> API de registro de SMS enviados.

@@ Línea 18: / Línea 18: @@
 La API de registro de SMS enviados '''se ofrece como un servicio web''', accesible mediante la URL:
-<pre>https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_sms_enviados?principal=xxxxxxxxx&pass=xxxxxxxx</pre>
+ https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_sms_enviados?principal=xxxxxxxxx&pass=xxxxxxxx
 Para los clientes de Canarias, la URL es:
-<pre>https://cgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_sms_enviados?principal=xxxxxxxxx&pass=xxxxxxxx</pre>
+ https://cgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_sms_enviados?principal=xxxxxxxxx&pass=xxxxxxxx

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

	Con la API de registro de SMS enviados, usted puede acceder a un '''listado de sus envíos de SMS vía HTTP''' sin necesidad de entrar en su cuenta. Esta herramienta es útil para integrar el reporte de envíos de {{PRODUCTO}} con su base de datos, CRM, web, etc.		Con la API de registro de SMS enviados, usted puede acceder a un '''listado de sus envíos de SMS vía HTTP''' sin necesidad de entrar en su cuenta. Esta herramienta es útil para integrar el reporte 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}}?]]

← Revisión anterior		Revisión del 10:48 24 dic 2015
Línea 86:		Línea 86:
	'''Indice'''		'''Indice'''

−	[[~~Portada~~]] >> [[Desarrolladores]] >> API de registro de SMS enviados.	+	[[Página principal]] >> [[Desarrolladores]] >> API de registro de SMS enviados.

@@ Línea 16: / Línea 16: @@
 La API de registro de SMS enviados '''se ofrece como un servicio web''', accesible mediante la URL:
-   https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_sms_enviados?principal=xxxxxxxxx&pin=1234
+   https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_sms_enviados?principal=xxxxxxxxx&pass=xxxxxxxx
 Para los clientes de Canarias, la URL es:
-   https://cgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_sms_enviados?principal=xxxxxxxxx&pin=1234
+   https://cgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_sms_enviados?principal=xxxxxxxxx&pass=xxxxxxxx
@@ Línea 26: / Línea 26: @@
 * '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}}.
@@ Línea 73: / Línea 73: @@
 ====Notas====
-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 1: / Línea 1: @@
-===Descripción===
+{{#seo:
 Con la API de registro de SMS enviados, usted puede acceder a un '''listado de sus envíos de SMS vía HTTP''' sin necesidad de entrar en su cuenta. Esta herramienta es útil para integrar el reporte de envíos de {{PRODUCTO}} con su base de datos, CRM, web, etc.
@@ Línea 28: / Línea 36: @@
-===Resultado===
+===Resultado APIde registro de SMS enviados===
 La URL api_sms_enviados devuelve una respuesta text/plain (o text/xml o text/html si se especifica con el parámetro 'tipo_salida'), con una serie de líneas de texto con los siguientes campos:
@@ Línea 63: / Línea 71: @@
-===Notas===
+====Notas====
 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.

@@ Línea 35: / Línea 35: @@
 * hora: hora en que empezó el envío (HH:MM:SS).
 * texto: texto del SMS.
 * destinatario: el número al que se envió el SMS.
 * nombre: nombre del destinatario (si se conoce).

@@ Línea 23: / Línea 23: @@
 ===Parámetros opcionales===
-* 'finicio' indica la fecha de inicio desde la que se quieren consultar los consumos. Debe estar en formato DD-MM-YYYY. Por defecto, toma el valor del día de hoy.
+* 'finicio' indica la fecha de inicio desde la que se quieren consultar los consumos. Debe estar en formato DD-MM-YYYY.
-* 'ffinal' indica la fecha final hasta la que se quieren consultar los consumos. Debe estar en formato DD-MM-YYYY. Por defecto, toma el valor del día de hoy.
+* 'ffinal' indica la fecha final hasta la que se quieren consultar los consumos. Debe estar en formato DD-MM-YYYY.
 * 'tipo_salida': puede ser 'text' (por defecto; para salida tipo texto plano), 'html' (para salida tipo tabla de HTML) o 'xml' (para salida tipo XML).
@@ Línea 35: / Línea 35: @@
 * hora: hora en que empezó el envío (HH:MM:SS).
 * texto: texto del SMS.
-* destinatario: el número al que se envió el fax.
+* destinatario: el número al que se envió el SMS.
 * nombre: nombre del destinatario (si se conoce).
 * pais: país del destinatario.