servicios web json - masmensajes.com.mx · a continuación se muestran las instrucciones de como...

Servicios WEB JSON

SERVICIOS WEB JSON v1.0 [02/11/2016]

SOPORTE TÉCNICO www.masmensajes.com.mx

01 800 700 6294 Ext. 117, 119 y 120 2

Tabla de contenido

Servicios WEB JSON de MasMensajes ...................................................................................................... 3

¿Qué es JSON? .......................................................................................................................................... 3

Funciones del Web Service JSON de MasMensajes ................................................................................ 4

Envío de Mensajes ................................................................................................................................ 4

Recepción de Respuestas .......................................................................................................................... 6

Recepción de Mensajes por Palabra Clave ............................................................................................... 7

Obtener Estatus de Envío ..................................................................................................................... 8

Obtener Estatus de Mensaje ................................................................................................................ 9

Obtener Estatus de Cuenta ............................................................................................................... 10

Ejemplos Método JSON ......................................................................................................................... 11

PHP ................................................................................................................................................... 11

Java ................................................................................................................................................... 11

Python .............................................................................................................................................. 12

JavaScript .......................................................................................................................................... 12

Consideraciones técnicas ....................................................................................................................... 13

Soporte Técnico ................................................................................................................................................... 13



01 800 700 6294 Ext. 117, 119 y 120 3

Servicios WEB JSON de MasMensajes

El servicio MasMensajes puede ser utilizado de manera automática para enviar y recibir mensajes SMS desde cualquier aplicación desarrollada por terceros. Esto se logra a través de servicios web que están puestos a disposición para cualquier usuario registrado en MasMensajes. El uso de los servicios web no tiene costo extra para el cliente y no tiene un límite de uso.

A continuación se da una breve explicación de la conectividad entre aplicaciones externas y el sistema MasMensajes.

¿Qué es JSON?

JSON (JavaScript Object Notation . Notación de Objetos de JavaScript) es un formato ligero de intercambio de datos. Leerlo y escribirlo es simple para humanos, mientras que para las máquinas es simple interpretarlo y generarlo. Está basado en un subconjunto del Lenguaje de Programación JavaScript, Standard ECMA.262 3rd Edition . Diciembre 1999. JSON es un formato de texto que es completamente independiente del lenguaje pero utiliza convenciones que son ampliamente conocidos por los programadores de la familia de lenguajes C, incluyendo C, C++, C#, Java, JavaScript, Perl, Python, y muchos otros. Estas propiedades hacen que JSON sea un lenguaje ideal para el intercambio de datos.

JSON está constituido por dos estructuras:

Una colección de pares de nombre/valor. En varios lenguajes esto es conocido como un objeto, registro, estructura, diccionario, tabla hash, lista de claves o un arreglo asociativo.

Una lista ordenada de valores. En la mayoría de los lenguajes, esto se implementa como arreglos, vectores, listas o secuencias.

Estas son estructuras universales; virtualmente todos los lenguajes de programación las soportan de una forma u otra. Es razonable que un formato de intercambio de datos que es independiente del lenguaje de programación se base en estas estructuras.



01 800 700 6294 Ext. 117, 119 y 120 4

Funciones del Web Service JSON de MasMensajes

A continuación se muestran las instrucciones de como consumir las diferentes funciones de nuestro servicio web JSON.

Envío de Mensajes

1. Su aplicación obtiene información de su base de datos o registros de cliente. 2. Su aplicación deberá generar la siguiente estructura en formato JSON:

{"user":"USUARIO", .................................................................................... El nombre de usuario de MasMensajes

"password":"CONTRASEÑA", ................................................................. Contraseña de la cuenta de MasMensajes

"service":"1",.................................................................. El número del servicio a utilizar (1 es envió de mensajes)

"data":{ ................................................................................ Contiene la información que necesita el Web Service

"message":"HOLA +NOMBRE+ GRACIAS POR REGISTRARTE ", ........................Texto a mandar como mensaje

"cellphones":["4492799655","4492559693"], ................................................................. Números de teléfono

"lada":"1", .......................................................................................................................... Identificador de lada

"combination":["DAVID,,,,","OMAR,,,,"] .......... campos genéricos para cambiar los mensajes individualmente

}}

3. Esto se puede enviar de dos maneras por su aplicación: en un archivo de texto con extensión .json o por medio de una variable llamada ‘JSON’.

4. La aplicación deberá subir el archivo o enviar la variable ‘JSON’ usando el método POST a la dirección: https://www.masmensajes.com.mx/wss/jsonService.php

5. El sistema contestará con un objeto JSON como el siguiente:

{"status":"Added", ................................................. Estado de la petición en caso de error este se presentaría aquí

"date":"2016-06-22 09:57:07",............................................................................. Fecha en que se registró el envío

"total":"'2'", ................................................................................................... El número total de mensajes a enviar

"totalAdd":"2", ......................................................................... El número total de mensajes registrados con éxito

"idSender":"27954301", ......................................................................................... Número identificador del envío

"idMessage":[{ ........................................................................ Contiene información de cada mensaje en el envío

"cellphone":"4492799655", ........................................................... Número celular al que se envía un mensaje

"id":"93231174"}, ........................................................................................ Número identificador del mensaje

{"cellphone":"4492559693",

"id":"93231175"}

]}

7. MasMensajes ejecutará el envío a la brevedad. Los mensajes enviados se descontarán del crédito de su cuenta MasMensajes de manera automática.

http://www.masmensajes.com.mx/wss/jsonService.php



01 800 700 6294 Ext. 117, 119 y 120 5

El número identificador de lada se puede consultar en la siguiente tabla:

ID PAIS

1 México

2 Estados Unidos

3 Colombia

4 Panamá

5 Costa Rica

6 Brasil

7 Perú

8 Paraguay

9 Ecuador

10 Belice

11 Costa Rica

12 Canadá

13 Guatemala

14 Venezuela

15 Argentina

16 República Dominicana

17 Honduras

18 Bolivia

19 Chile

20 Nicaragua

NOTA: El servicio de mensajes internacional solo está disponible por web service.



01 800 700 6294 Ext. 117, 119 y 120 6

Recepción de Respuestas

1. Su aplicación obtiene información de su base de datos o registros de cliente. 2. Su aplicación deberá generar la siguiente estructura en formato JSON:+

{"user":"USUARIO", .................................................................................... El nombre de usuario de MasMensajes

"password":"CONTRASEÑA", ................................................................. Contraseña de la cuenta de MasMensajes

"service":"2", ........................................................... El número del servicio a utilizar (2 es recepción de mensajes)

"data":{ ................................................................................... Contiene la información que necesita el web service

"from":"2016-07-01", .............................................................................Fecha inicio de la búsqueda (opcional)

"to":"2016-07-21", ................................................................................... Fecha final de la búsqueda (opcional)

"type":"1” ............... Tipo de respuesta (1- Todas las respuestas 2- Respuestas no leídas 3- Respuestas leídas)

}}

*Nota: si el objeto JSON contiene el campo “type” devolverá todos los registros de respuestas según su tipo, en este caso los campos “from” y “to” son innecesarios, en caso de que se necesite consultar por fechas determinadas omita el campo “type” y se obtendrá todas las respuestas sin hacer distinción de tipo.




{"estatus":"Success", ............................................. Estado de la petición en caso de error este se presentaría aquí

"Responses":[ ........................... Muestra información referente a cada respuesta que cumpla con los parámetros

{"idSender":"27965161", ............................................................................ Número identificador de envío

"idMessage":"93255059", ......................................Número identificador del mensaje ligado a respuesta

"message":"Respuesta", ........................................................................... Texto contenido en la respuesta

"cellphone":"4957553102", ..................................................... Número celular que respondió al mensaje

"receptionDate":"2016-07-21 11:29:28", ....................................... Fecha en que se registró la respuesta

"status":"1"} ............................................................ Código de estado de respuesta (1-Leído, 0- No leído)

]}

Si se utiliza el campo “type” con la opción 2 ó 3 en la consulta, no parecerá el campo “status” en la

respuesta del servicio.

En caso de no encontrar resultados, el sistema responderá de la siguiente manera:

{"estatus":"Success","Responses":[]}

https://www.masmensajes.com.mx/wss/jsonService.php



01 800 700 6294 Ext. 117, 119 y 120 7

Recepción de Mensajes por Palabra Clave


{"user":"USUARIO", ................................................................................... El nombre de usuario de MasMensajes

"password":"CONTRASEÑA", ................................................................ Contraseña de la cuenta de MasMensajes

"service":"3", ............................... El número del servicio a utilizar (3 es recepción de mensajes por palabra clave)

"data":{ ................................................................................Contiene la información que necesita el web service

"from":"2016-07-21", .............................................................................. Fecha inicio de la búsqueda (opcional)

"to":"2016-07-21", .................................................................................... Fecha final de la búsqueda (opcional)

"type":"1"……………………...Tipo de mensajes (1- Todos los mensajes 2- Mensajes leídos 3- Mensajes no leídos)

}}

*Nota: si el objeto JSON contiene el campo “type” devolverá todos los registros de mensajes según su tipo, en este caso los campos “from” y “to” son innecesarios, en caso de que se necesite consultar por fechas determinadas omita el campo “type” y se obtendrá todos los mensajes sin hacer distinción de tipo.





"Responses":[ ............................. Muestra información referente a cada mensaje que cumpla con los parámetros

{"keyword":"PCLAVE", .................................................................................. Palabra clave utilizada en mensaje

"message":" numero de folio EF0129872 ", ............................................................ Texto contenido en mensaje

"cellphone":"4851066302", ................................................................... Número celular que mando el mensaje

"receptionDate":"2016-07-21 17:51:33" .................................................... Fecha en que se recibió el mensaje

"status":"0"}.................................................................... Código de estado de respuesta (1-Leído, 0- No leído)

]}

Si se utiliza el campo “type” con la opción 2 ó 3 en la consulta, no parecerá el campo “status” en la

respuesta del servicio.

En caso de no encontrar resultados, el sistema responderá de la siguiente manera:

{"estatus":"Success","Responses":[]}




01 800 700 6294 Ext. 117, 119 y 120 8

Obtener Estatus de Envío


{"user":"USUARIO", .................................................................................... El nombre de usuario de MasMensajes "password":"CONTRASEÑA", ................................................................. Contraseña de la cuenta de MasMensajes

"service":"4", ............................................................. El número del servicio a utilizar (4 es obtención de estatus)

"data":{ .................................................................................Contiene la información que necesita el web service

"idSender ":"27965242 " ................................................................................ El número identificador del envío

}}





"idsSender":{ .................................................................................................... Contienen la información del envío

"id":"27965242", ....................................................... Número identificador del envío que se está consultando

"message":" HOLA +NOMBRE+ GRACIAS ", ................................... Texto que contienen los mensajes del envío

"send":"2", ................................................................................... Número de mensajes que han sido enviados

"Not Send":"0",............................................................. Número de mensajes que no han sido enviados (error)

"toSend":"0" .................................................................................. Número de mensajes en espera de enviarse

}}




01 800 700 6294 Ext. 117, 119 y 120 9

Obtener Estatus de Mensaje



"service":"4", .............................................................. El número del servicio a utilizar (4 es obtención de estatus)

"data":{ ................................................................................. Contiene la información que necesita el web service

"idMessage":" 93256183" ............................................................................. El número identificador del envío

}}




{"estatus":"Success", ........................................... Estado de la petición en caso de error este se presentaría aquí

"idsMessage":{ ….………………........................................................................Contienen la información del mensaje

"id":"93256183", ........................................................................ Número identificador del mensaje consultado

"message":" HOLA David GRACIAS ",................................................................... Texto contenido en el mensaje

"cellphone":"5551063102", ....................................................... Número celular al cual el mensaje fue enviado

"status":"S"}} ………...Código que indica el estado del mensaje(S- Enviado. B- En proceso. U– Sin enviar N- Error.)




01 800 700 6294 Ext. 117, 119 y 120 10

Obtener Información de Cuenta



"service":"5",…....................................El número del servicio a utilizar (5 es obtención de información de cuenta)

"data":{ .................................................................................... Contiene la información que necesita el web service

"user":" USUARIO" ............................................................................. El nombre de usuario de MasMensajes

}}




{"estatus":"Success", ........................................... Estado de la petición en caso de error este se presentaría aquí

"username":"USUARIO", ........................................................... Nombre de usuario registrado en MasMensajes

"name":" Gerardo", ......................................................................................................... Nombredelusuariodelacuenta

"lastname":"Nava Fernandez", ........................................................................... Apellidos del usuario de la cuenta

"mail":"[email protected]”, ................................................. Correo electrónico registrado en MasMensajes

"credit":"100” ............................................................................................ Crédito disponible para enviar mensajes

}


mailto:[email protected]



01 800 700 6294 Ext. 117, 119 y 120 11

Ejemplos Método JSON Php

Ejemplo PHP usando CURL

1. <?php 2.

$post=json_encode(array("user"=>"TU_USUARIO","password"=>"TU_CONTRASEÑA","service"=>"1

","data"=>array("message"=>" PRUEBA CON +NOMBRE+

","cellphones"=>array("5567412589","6245317895"),"lada"=>"1","combination"=>array("Ric

ardo,PRUEBA 2,,,","Richard,PRUEBA 3,,,"))));

3. 4. $target_url = 'http://www.masmensajes.com.mx/wss/jsonService.php'; 5. $ch = curl_init(); 6. curl_setopt($ch,CURLOPT_URL,$target_url); 7. curl_setopt($ch,CURLOPT_POST,1); 8. curl_setopt($ch,CURLOPT_POSTFIELDS,array("JSON"=>$post)); 9. curl_setopt($ch,CURLOPT_RETURNTRANSFER,1); 10. curl_exec($ch); 11. curl_close($ch); 12. ?>

Ejemplo PHP usando HTML

1. <?php 2.

$post=json_encode(array("user"=>"TU_USUARIO","password"=>"TU_CONTRASEÑA","service"=>"1

","data"=>array("message"=>" PRUEBA CON LADA

","cellphones"=>array("5864759231","4578961235"),"lada"=>"1","combination"=>array("Ric

ardo Noyola,PRUEBA 2,,,","Richard Parker,PRUEBA 3,,,"))));

3. ?> 4. <form action="https://www.masmensajes.com.mx/wss/jsonService.php" method="post"> 5. <p> 6. <textarea name="JSON" id="JSON" cols="100" rows="20"><?php echo $post ?> 7. </textarea> 8. </p> 9. <p><input name="enviar" type="submit" value="Upload File" /></p> 10. </form>

Java

Requisito: tener instalada la librería JSON

1. public static void send() throws IOException, JSONException { 2. URL url = new URL("http://www.masmensajes.com.mx/wss/jsonService.php"); 3. 4. JSONObject JSON = new JSONObject(); 5. JSON.put("user","TU_USUARIO"); 6. JSON.put("password", "TU_CONTRASEÑA"); 7. JSON.put("service", "1"); 8. JSONObject data = new JSONObject(); 9. String mensaje = "HOLA +NOMBRE+ GRACIAS POR REGISTRARTE "; 10. mensaje = mensaje.replace("+", "%2B"); 11. data.put("message", mensaje); 12. JSONArray celulares = new JSONArray(); 13. celulares.put("0123456789"); 14. celulares.put("7894561230"); 15. data.put("cellphones", celulares); 16. data.put("lada", "1"); 17. JSONArray comb = new JSONArray(); 18. comb.put("Ricardo,PRUEBA 2,,,"); 19. comb.put("Richard,PRUEBA 3,,,"); 20. data.put("combination",comb); 21. JSON.put("data",data);

http://www.php.net/json_encode

http://www.php.net/array




http://www.php.net/curl_init

http://www.php.net/curl_setopt





http://www.php.net/curl_exec

http://www.php.net/curl_close

http://www.php.net/json_encode





http://www.google.com/search?hl=en&q=allinurl%3Adocs.oracle.com+javase+docs+api+ioexception

http://www.google.com/search?hl=en&q=allinurl%3Adocs.oracle.com+javase+docs+api+url

http://www.google.com/search?hl=en&q=allinurl%3Adocs.oracle.com+javase+docs+api+url

http://www.google.com/search?hl=en&q=allinurl%3Adocs.oracle.com+javase+docs+api+string



01 800 700 6294 Ext. 117, 119 y 120 12

22. String parametro = "JSON="+JSON.toString(); 23. 24. byte[] postDataBytes = parametro.getBytes("UTF-8"); 25. 26. HttpURLConnection conn = (HttpURLConnection) url.openConnection(); 27. conn.setRequestMethod("POST"); 28. conn.setRequestProperty("Content-Type", 29. "application/x-www-form-urlencoded"); 30. conn.setRequestProperty("Content-Length", 31. String.valueOf(postDataBytes.length)); 32. conn.setDoOutput(true); 33. conn.getOutputStream().write(postDataBytes); 34. 35. Reader in = new BufferedReader(new InputStreamReader( 36. conn.getInputStream(), "UTF-8")); 37. for (int c = in.read(); c != -1; c = in.read()) 38. System.out.print((char) c); 39. }

Python

1. import requests 2. import json 3. datos = json.dumps({'user':'TU_USUARIO','password':'TU_CONTRASEÑA', 'service':'1','dat

a':{'message':'python prueba post

+NOMBRE+', 'cellphones':('0123456789', '0123456789'), 'lada':'1', 'combination':('Edua

rdo,,,,','Erika,,,,')}})

4. r = requests.post("https://www.masmensajes.com.mx/wss/jsonService.php/post", data=datos)

5. print(r.url) 6. print(r.text)

JavaScript

1. function prueba(){ 2.

var post = {user:"TU_USUARIO", password:"TU_CONTRASEÑA", service:1, data:{ message:"

HOLA +NOMBRE+ GRACIAS POR REGISTRARTE

",cellphones:["5423114578","7854961230"], lada:1, combination:["DAVID,,,,","OMAR,,,,"]

}};

3. console.log(datos); 4. $.ajax({ 5. url: "https://www.masmensajes.com.mx/wss/jsonService.php", 6. type: 'POST', 7. data:{ 8. JSON: post 9. }, 10. success: function(res) { 11. console.log(res); 12. } 13. }); 14. }


http://www.google.com/search?hl=en&q=allinurl%3Adocs.oracle.com+javase+docs+api+httpurlconnection

http://www.google.com/search?hl=en&q=allinurl%3Adocs.oracle.com+javase+docs+api+httpurlconnection


http://www.google.com/search?hl=en&q=allinurl%3Adocs.oracle.com+javase+docs+api+reader

http://www.google.com/search?hl=en&q=allinurl%3Adocs.oracle.com+javase+docs+api+bufferedreader

http://www.google.com/search?hl=en&q=allinurl%3Adocs.oracle.com+javase+docs+api+inputstreamreader

http://www.google.com/search?hl=en&q=allinurl%3Adocs.oracle.com+javase+docs+api+system



01 800 700 6294 Ext. 117, 119 y 120 13

Consideraciones técnicas

Las adecuaciones de su sistema de información para el funcionamiento con Mas Mensajes deberán ser realizadas por su integrador de TI o un experto en la materia. MasMensajes puede dar soporte en cuanto al desarrollo vía telefónica o por correo electrónico.

Soporte Técnico

Tecnología y Soluciones Aplicadas S.A. de C.V.

Brasilia 107 Col. La Fuente

Aguascalientes, Ags. CP 20239

Tel. 01 800 700 6294 ext. 117, 119 y 120

servicios web json - masmensajes.com.mx · a continuación se muestran las instrucciones de como...

Documents