Uso de la API

En todos los planes de MobilePush se incluye el acceso a nuestra API, con la cual podrás conectar con nuestro servidor de forma remota.

Pongamos de ejemplo que creas una aplicación para un cliente, el cual requiere de su propio panel de control para enviar sus propias notificaciones sin que tenga que recurrir a nosotros o que nosotros tengamos que darle acceso a nuestro panel de MobilePush.

 Para conectar con nuestra cuenta y enviar notificaciones a través de una APP concreta, previamente configurada, usaremos los siguientes parámetros:

  • appid desde este parámetro enviaremos nuestra appid, que la encontraremos en el panel de nuestra APP
  • appsecret desde este otro parámetro enviaremos nuestra appsecret, situada en el panel de nuestra APP
  • send_ios este parámetro lo usaremos para indicar si queremos enviar la notificación a los dispositivos iOS, y el valor a enviar debe ser ios
  • send_android este parámetro lo usaremos para indicar si queremos enviar la notificación a los dispositivos Android, y el valor a enviar debe ser android
  • send_text a través de este valor, enviaremos el texto de nuestra notificación
  • badge en este parámetro colocaremos el nº de badge que queremos que muestre el icono de nuestra APP en los dispositivos iOS. Sólo para iOS
  • send_hora si queremos programar una notificación para un día y hora concretos, debemos enviar por este parámetro la hora deseada en el siguiente formato: 00:00 (hh:00), dejando siempre los minutos a cero
  • send_dia si queremos programar una notificación para un día y hora concretos, debemos enviar por este parámetro la fecha deseada en el siguiente formato: 29-07-2014  (dd-mm-yyyy), respetando los guiones medios y el número de caracteres

Para testear el funcionamiento de nuestra API, por si hemos colocado algún código erróneo o algo similar, hemos creado otro parámetro que nos dará una respuesta del funcionamiento del envío.

  • respuesta si enviamos éste parámetro con el valor 1, nos devolverá la respuesta del envío, tanto si fué exitoso o si hubo algún error en el procedimiento

Para el envío de nuestros datos, necesitaremos hacerlo por el método POST.

Llegados a este punto, veamos un simple ejemplo de nuestro código:

<!doctype html>
<html>
<head>
<meta charset="UTF-8">
<title>EJEMPLO PUSH API</title>
<link rel="stylesheet" href="http://maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
</head>

<body>
<div class="container">
<h2>Ejemplo MobilePush API</h2>
<div style="width:500px; margin:auto">
<form action="" id="sendpush" method="post" role="form">
<div class="form-group"><label for="checkios">Usuarios Android:</label> <input name="send_android" type="checkbox" value="android" id="checkios">
<label>Usuarios iOS:</label> <input name="send_ios" type="checkbox" value="ios"></div>
<div class="form-group"><label>Mensaje:</label> <textarea placeholder="Máximo 220 caracteres" class="form-control" name="send_text" cols="" rows="4"></textarea></div>
<div class="form-group"><label>Hora:</label> <input placeholder="00:00" class="form-control" name="send_hora" type="text" value=""></div>
<div class="form-group"><label>Dia:</label> <input placeholder="dd-mm-aaaa" class="form-control" name="send_dia" type="text" value=""></div>
<div class="form-group"><label>Badges:</label> <input placeholder="Máximo 2 dígitos" class="form-control" name="badges" type="text" value="1"></div>
<div class="form-group"><label>Respuesta:</label> <input class="form-control" name="respuesta" type="text" value="1"></div>
<div class="form-group"><label>AppID:</label> <input class="form-control" name="appid" type="text" value="svihbifc"></div>
<div class="form-group"><label>AppSecret:</label> <input class="form-control" name="appsecret" type="text" value="rxlqn1esr23mpnof"></div>
<input name="send" class="btn btn-success" id='post' type="button" value="Enviar">
</form>
 </div>
<!--DIV PARA RESPUESTAS-->
<div id='response'></div>
 </div>
<script src="https://ajax.googleapis.com/ajax/libs/jquery/1.7.1/jquery.min.js "></script>
<script>
$(document).ready(function(){
 $('#post').click(function(e){
 e.preventDefault();
 /*MENSAJE DE ESPERA*/
 $('#response').html("<b>Cargando datos.....</b>");
 /*RECOGEMOS DATOS DEL FORMULARIO*/
 var datos = $('#sendpush').serialize();
 /*ENVIAMOS DATOS*/
 $.post('http://api.mobilepush.es/V1/', datos, function(data){
 /*RECIBIMOS RESPUESTA*/
 $('#response').html(data);
 }).done(function() {

 }).fail(function() {

 }) .always(function() {

 });
 })
});
</script>
</body>
</html>

Deja un comentario