PDF de programación - Protocolo Propietario para el envío y recepción de SMS y MMS

Protocolo Propietario para el env´ıo y

recepci´on de SMS y MMS

LleidaNetworks Serveis Telem`atics, S.L.

[email protected]

21 de abril de 2008

´INDICE

´Indice

1. Introducci´on

2. Comandos Generales

2.1.
login . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.2. saldo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.3. ping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.4.
infonum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.5. tarifa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.6. quit
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

2

5

6
6
6
6
7
7
7

3. Comandos para el env´ıo de MT simples

fsubmit, fbsubmit y fusubmit

8
8
3.1. submit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
8
3.2. bsubmit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
8
3.3. usubmit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
9
3.4.
. . . . . . . . . . . . . . . . . .
9
3.5. dsubmit, dbsubmit, y dusubmit . . . . . . . . . . . . . . . . .
3.6. dfsubmit, dbfsubmit y dfusubmit
. . . . . . . . . . . . . . . . 10
3.7. waplink . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
3.8. dst . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
3.9. msg
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
3.10. filemsg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
3.11. mmsmsg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
3.12. envia . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
3.13. acuseon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
3.14. acuseoff . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
3.15. acuse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
3.16. acuseack . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
3.17. trans . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

4. Comandos para la recepci´on de SMS (NO Premium)

18
4.1. allowanswer . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
incomingmo . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
4.2.
4.3.
incomingmoack . . . . . . . . . . . . . . . . . . . . . . . . . . 19

5. Comandos para la recepci´on de SMS (Premium)

20
5.1. deliver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
5.2. resp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
5.3. bresp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
5.4. waplinkresp . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

´INDICE

3

6. Comandos para la resoluci´on de MSIDSN

22
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
6.1. checkall
6.2. rcheckall
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
6.3. checknetwork . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
6.4. rchecknetwork . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
6.5. Posibles valores del elemento rcode . . . . . . . . . . . . . . . 25

Copyright

(c) 2007 - LleidaNetworks Serveis Telematics, S.L.

Todos los derechos reservados

Este documento contiene informaci´on propietaria y confidencial. Queda total-
mente prohibido distribuir sus contenidos total o parcialmente por cualquier
medio, sea f´ısico o electr´onico, sin la autorizaci´on expresa de su titular.

1 INTRODUCCI ´ON

1.

Introducci´on

5

El objetivo del siguiente protocolo es proporcionar un sistema para redes
IP para el env´ıo y recepci´on de SMS o MMS que sea f´acil de implementar
por parte del cliente.

Todos los mensajes que se intercambian entre cliente y servidor son l´ıneas
de texto acabadas en return (ASCII 10), y siempre tienen la misma sintaxis:

<etiq> <comando> [par´ametros]\n

La etiqueta sirve para poder enlazar f´acilmente los comandos con las res-
puestas que generan, ya que la respuesta siempre va precedida por la misma
etiqueta que el comando. La etiqueta tiene que ser una secuencia monot´onica
creciente de enteros.

Ejemplo:

>> 1 LOGIN user password
<< 1 OK 345 0
>> 2 DST +34666666666
<< 2 OK 1

...

Los SMS pueden ser de tipo MO-MT o MT. Los MO-MT son los SMS
de pago por parte del usuario, y consisten en parejas de mensajes formadas
por un MO (mobile originated) enviado por el usuario y un MT (mobile
terminated) de confirmaci´on. Los de tipo MT simple son gratuitos para el
usuario y pueden enviarse sin necesidad de un SMS de respuesta por parte
del usuario.

El env´ıo de un MT simple consume cr´editos del saldo del cliente. El env´ıo

de un MT de respuesta a un MO no consume saldo.

El saldo para cada cliente es un numero decimal que se incrementa cuando
se realizan recargas y se decrementa cuando se realizan env´ıos. La cantidad
de cr´editos decrementada var´ıa seg´un el pa´ıs de destino y las opciones acti-
vadas para el MT. Puede consultar las tarifas y pa´ıses en nuestra web:

http://www.lleida.net/red

Los comandos disponibles son case insensitive.

2 COMANDOS GENERALES

6

2. Comandos Generales

2.1.

login

Comando para autenticarse al servidor.

Sintaxis:

<etiq> LOGIN <usuario> <contrase~na>

Respuestas:

<etiq> OK <saldo (parte entera)> <saldo (parte decimal)>
<etiq> NOOK <mensaje de error>

2.2.

saldo

Retorna el saldo de MT disponible.

Sintaxis:

<etiq> SALDO

Respuesta:

<etiq> RSALDO <saldo (parte entera)> <saldo (parte decimal)>

2.3. ping

Este comando lo env´ıa el servidor para verificar que el programa cliente

est´a presente y funcionando correctamente.

Sintaxis:

<etiq> PING <timestamp>

Respuesta (obligatoria):

<etiq> PONG <timestamp>

2 COMANDOS GENERALES

7

2.4.

infonum

Este comando le permite consultar informaci´on sobre un numero de m´o-
vil. Retorna el prefijo (codigo internacional + prefijo operadora), el c´odigo
GSM de pa´ıs y el c´odigo GSM de operadora (informaci´on ´util para el env´ıo
de logos Nokia). Si alg´un dato se desconoce, su valor es ”–” (dos guiones).

Sintaxis:

<etiq> INFONUM <numero>

Respuesta:

<etiq> RINFONUM <prefijo> <c´odigo pa´ıs> <c´odigo operadora>

2.5.

tarifa

Indica la tarifa aplicable a un n´umero determinado. <acuse> y <remi-
tente> es el precio de los dos servicios que se tienen que sumar al precio del
MT en caso que se utilicen dichas opciones.

Sintaxis:

<etiq> TARIFA <numero>

Respuesta:

<etiq> RTARIFA <c´odigo tarifa> <precio MT> <acuse> <remitente>

2.6. quit

Cierra la sesi´on.

Sintaxis:

<etiq> QUIT

Respuesta:

<etiq> BYE

3 COMANDOS PARA EL ENV´IO DE MT SIMPLES

8

3. Comandos para el env´ıo de MT simples

3.1.

submit

Env´ıa un MT de texto.

Sintaxis:

<etiq> SUBMIT <destino> <texto>

Respuestas:

<etiq> SUBMITOK <saldo restante (entera)> <saldo (decimal)>
<etiq> NOOK <error>

3.2. bsubmit

Env´ıa un MT binario.

Sintaxis:

<etiq> BSUBMIT <destino> <datos en Base64>

Respuestas:

<etiq> BSUBMITOK <saldo restante (entera)> <saldo (decimal)>
<etiq> NOOK <error>

3.3. usubmit

Env´ıa un MT con texto Unicode.

Sintaxis:

<etiq> USUBMIT <destino> <texto Unicode en Base64>

Respuestas:

<etiq> USUBMITOK <saldo restante (entera)> <saldo (decimal)>
<etiq> NOOK <error>

3 COMANDOS PARA EL ENV´IO DE MT SIMPLES

9

3.4.

fsubmit, fbsubmit y fusubmit

Env´ıa un MT personalizando el remitente. Mediante este comando a los
destinatarios del MT les aparecer´a como remitente el texto/n´umero que se
especifique.

Sintaxis:

<etiq> FSUBMIT <remitente> <destino> <texto>
<etiq> FBSUBMIT <remitente> <destino> <datos en Base64>
<etiq> FUSUBMIT <remitente> <destino> <texto Unicode en Base64>

Respuestas:

<etiq> FSUBMITOK <saldo restante (entera)> <saldo (decimal)>
<etiq> FBSUBMITOK <saldo restante (entera)> <saldo (decimal)>
<etiq> FUSUBMITOK <saldo restante (entera)> <saldo (decimal)>
<etiq> NOOK <error>

3.5. dsubmit, dbsubmit, y dusubmit

Programa un MT para su env´ıo en una fecha y hora determinada.

Sintaxis:

<etiq> DSUBMIT <fecha> <destino> <texto>
<etiq> DBSUBMIT <fecha> <destino> <datos en Base64>
<etiq> DUSUBMIT <fecha> <destino> <texto Unicode en Base64>

El par´ametro <fecha> es la fecha y hora en que el servidor enviar´a el MT

y debe tener el formato YYYYMMDDhhmm[+-]ZZzz.

La parte [+-]ZZzz es la zona horaria (el n´umero de horas a sumar o restar
de la fecha GMT). Por ejemplo, el 1 de Septiembre de 2007 a las 13:00 en la
zona horaria de Espa˜na el valor debe ser 200709011300+0100.

Respuestas:

<etiq> DSUBMITOK <saldo restante (entera)> <saldo (decimal)>
<etiq> DBSUBMITOK <saldo restante (entera)> <saldo (decimal)>
<etiq> DUSUBMITOK <saldo restante (entera)> <saldo (decimal)>
<etiq> NOOK <error>

3 COMANDOS PARA EL ENV´IO DE MT SIMPLES

10

3.6. dfsubmit, dbfsubmit y dfusubmit

Programa un MT con remitente personalizado para su env´ıo en una fecha

y hora determinada.

Sintaxis:

<etiq> DFSUBMIT <fecha> <remitente> <destino> <texto>
<etiq> DFBSUBMIT <fecha> <remitente> <destino> <datos en Base64>
<etiq> DFUSUBMIT <fecha> <remitente> <destino> <texto Unicode en Base64>

El par´ametro <fecha> es la fecha y hora en que el servidor enviar´a el MT

y debe tener el formato YYYYMMDDhhmm[+-]ZZzz.

Respuestas:

<etiq> DFSUBMITOK <saldo restante (entera)> <saldo (decimal)>
<etiq> DFBSUBMITOK <saldo restante (entera)> <saldo (decimal)>
<etiq> DFUSUBMITOK <saldo restante (entera)> <saldo (decimal)>
<etiq> NOOK <error>

3.7. waplink

Env´ıa un MT que contiene un link web a un contenido multimedia.

Sintaxis:

<etiq> WAPLINK <destino> <url> <comentario>

Notas:

<url>: Es el link al contenido que se quiere enviar al m´ovil. Normal-
mente ser´a un link a una imagen, melod´ıa o aplicaci´on.

<comentario>: Es el texto que le aparece como comentario del mensaje
al destinatario antes de descargar su contenido.

Respuestas:

<etiq> WAPLINKOK <saldo restante (entera)> <saldo (decimal)>
<etiq> NOOK <error>

3 COMANDOS PARA EL ENV´IO DE MT SIMPLES

11

3.8. dst

A˜nade numeros en la lista de destinos para el env´ıo masivo de un mensaje
a m´ultiples destinos. Se pueden indi