Webservices

Se ha publicado una API con webservices de MunicipApp, que permite integrar cualquier página web y/o software propio del ayuntamiento con nuestra aplición. Haciendo las llamadas a los servicios web que a continuación se detallan, se podrá añadir, solicitar, actualizar o eliminar las Noticias, Eventos y elementos de Turismo que se deseen.

Para solicitar el acceso a dichos servicios web es necesario solicitarlo mediante una incidencia de GLPI. Puesto que dichos servicios web van securizados para que cualquiera no pueda hacer uso de ellos. Por lo tanto serán los informáticos del departamento los encargados de facilitar las credenciales necesarias para que puedan usarse.

Servicios:

Noticias

addNoticias

Web Service que añade una noticia a la BD, con los datos que le pasemos como parámetros.

Encabezado:

@POST
@Path("/addNoticia")
@Consumes({ MediaType.APPLICATION_JSON })
public Response addNoticia(String strNoticia) throws SQLException,
ParseException, JSONException

Parámetros (JSON): Objeto JSON con los siguientes campos

{
   "idMunicipio": 3013,                       //(int)
   "usuario": "ayto_user",                    //(String)
   "pass": "pass",                            //(String)
   "titulo": "título noticia",                //(String)
   "contenido": "<p>contenido noticia</p>",   //(String)
   "fecha": "16-10-2015",                     //(String dd/mm/yyyy)
   "estado": "publish",                       //”publish”
   "tipo": "post"                             //”post”
}

Salida: 1 noticia añadida, -1 error al insertar, -2 parámetros incorrectos.

updateNoticias

Web Service que modifica una noticia de la BD, con los datos que le pasemos como parámetros.

Encabezado:

@POST
@Path("/updateNoticia")
@Consumes({ MediaType.APPLICATION_JSON })
public Response updateNoticiaIntranet(String strNoticia)
throws SQLException, ParseException, JSONException

Parámetros (JSON): Objeto JSON con los siguientes campos

{
   "idMunicipio": 3013,                       //(int)
   "usuario": "ayto_user",                    //(String)
   "pass": "pass",                            //(String)
   "idNoticia": 13,                           //(int)
   "titulo": "Título noticia",                //(String)
   "contenido": "<p>contenido noticia</p>",   //(String)
   "fecha": "16-10-2015",                     //(String dd/mm/yyyy)
   "estado": "publish",                       //”publish”
   "tipo": "post"                             //”post”
}

Salida: 0 noticia modificada, -1 error al modificar, -2 parámetros incorrectos.

deleteNoticia

Web Service que elimina UNA o MÁS  noticias de la BD, con los datos que le pasemos como parámetros.

Encabezado:

@POST
@Path("/deleteNoticias")
@Consumes({ MediaType.APPLICATION_JSON })
public Response deleteNoticias(String strNoticias) throws IOException

Parámetros (JSON): Objeto JSON con los siguientes campos

{
   "idMunicipio": 3013,          //(int)
   "usuario": "ayto_user",       //(String)
   "pass": "pass",               //(String)
   "idNoticias": "11-10"         //(String) “1” (elimina la noticia 1)
                                 //“1-2-3”(elimina 1, 2,3) Ids entre por guiones “-“
}

Salida: n>=0 número de noticias eliminadas, -1 error al modificar, -2 parámetros incorrectos.

 

getNoticiasIntranet

Web Service que lista un array de objectos JSON con todas las noticias del municipio que le pasemos como  parámetro.

Encabezado:

@GET
@Path("/getNoticiasIntranet/{idMunicipio}")
@Produces(MediaType.APPLICATION_JSON + ";charset=utf-8")
public String getNoticiasIntranet(@PathParam("idMunicipio") int idMunicipio) {

Parámetros (texto plano): ID del municipio.

http://aytosapp.diputacionalicante.es:8080/AytosApp/webService/getNoticiasIntranet/2000

(Llamada desde navegador)

Salida: Array de objetos JSON (noticias)

 

Eventos

addEvento

Web Service que añade un evento a la BD, con los datos que le pasemos como parámetros.

Encabezado:

@POST
@Path("/addNoticia")
@Consumes({ MediaType.APPLICATION_JSON })
public Response addNoticia(String strNoticia) throws SQLException,
ParseException, JSONException {

Parámetros (JSON): Objeto JSON con los siguientes campos

{
   "idMunicipio": 3013,          // (int)
   "usuario": "ayto_user",       //(String)
   "pass": "pass",               //(String)
   "titulo": "título evento",    //(String)
   "start": "16/10/2015",        //(String dd/mm/yyyy)
   "end": "18/10/2015",          //(String dd/mm/yyyy)
   "lugar": "Alguenya",          //(String)
   "direccion": "Plaza Juan Carlos I, nº 3",  //(String)
   "cp": "03150",                       //(String – 5 digitos)
   "descripcion": "Descripción Evento", //(String)
   "color": "7"                         //(String)(Opcional solo saldría en Intranet)
}

Salida: 1 evento añadido, -1 error al insertar, -2 parámetros incorrectos.

updateEvento

Web Service que modifica el evento deseemos, con los datos pasados como parámetros.

Encabezado:

@POST
@Path("/updateEvento")
@Consumes({ MediaType.APPLICATION_JSON })
public Response updateEvento(String strEvento) throws SQLException,
ParseException, JSONException {

Parámetros (JSON): Objeto JSON con los siguientes campos

{
    "idMunicipio": 3013,                //(int)
    "usuario": "ayto_user",             //(String)
    "pass": "pass",                     //(String)
    "idEvento": 20,                     //(int)
    "titulo": "Evento modificar",       //(String)
    "start": "29/10/2014",              //(String dd/mm/yyyy)
    "end": " 30/10/2014",               //(String dd/mm/yyyy)
    "lugar": "Los Montesinos",          //(String)
    "direccion": "Av. La estación",     //(String)
    "cp": "03140",                      // (String 5 elementos)
    "descripcion": "Descripción evento", //(String)
    "color": "7"                         // (int)
}

Salida: 1 evento modificado, -1 error al modificar, -2 parámetros incorrectos.

deleteEvento

Web Service, que elimina UN evento de la BD, que le indiquemos como parámetro.

Encabezado:

@POST
@Path("/deleteEvento")
@Consumes({ MediaType.APPLICATION_JSON })
public Response deleteEvento(String strEvento) throws IOException {

Parámetros (JSON): Objeto JSON con los siguientes campos

{
   "idMunicipio": 3013,                //(int)
   "usuario": "ayto_user",             //(String)
   "pass": "pass",                     //(String)
   "idEvento": 12                      //(int)
}

Salida: 1 evento eliminados, -1 error al eliminar, -2 parámetros incorrectos.

getEventosIntranet

Web Service que lista un array de objectos JSON con todas los eventos del municipio que le pasemos como parámetro.

Encabezado:

@GET
@Path("/getEventosIntranet/{idMunicipio}")
@Produces(MediaType.APPLICATION_JSON + ";charset=utf-8")
@Consumes("text/plain")
public String getEventosIntranet(@PathParam("idMunicipio") int idMunicipio) {

Parámetros (texto plano): ID del municipio.

http://aytosapp.diputacionalicante.es:8080/AytosApp/webService/getEventosIntranet/2000

(Llamada desde navegador)

Salida: Array de objetos JSON (eventos)

Municipios

updateInfoMun

Web Service, que modifica un municipio de la BD, con los datos que le indiquemos como parámetro.

Encabezado:

@POST
@Path("/updateInfoMun")
@Consumes({ MediaType.APPLICATION_JSON })
public Response updateInfoMun(String strInfoMun) throws SQLException,
JSONException {

Parámetros (JSON): Objeto JSON con los siguientes campos

{
    "idMunicipio": 3013,                       //(int)
    "usuario": "ayto_user",                    //(String)
    "pass": "pass",                            //(String)
    "direccion": "PLAZA JUAN CARLOS I, 32",    //(String)
    "cp": "03140",                             //(String 5 digitos)
    "telefono": "965476001",                   //(String)
    "fax": "965476300",                        //(String)
    "email": "info@alguenya.es",               //(String)
    "web": "http:www.alguenya.es",             //(String)
    "latitud": 38.397,                         //(double)
    "longitud": -1.00322                       //(double)
}

Salida: 1 noticia añadida, -1 error al insertar, -2 parámetros incorrectos.