Tutorial para los Servicios Web de SWIM

Los servicios web SWIM RESTful han sido implementados usando Dropwizard[1]. La versión actual expone una interfaz que recibe un escenario personalizado del usuario en formato JSON. (véase vista de modelo de datos para información adicional en el esquema JSON de escenario personalziado). El servicio web actualmente se conecta a la versión de Febrero 25 2018 de el modelo de Cubeta desarrollado con GAMS.

Información del Servicio

URL del Servicio: https://services.cybershare.utep.edu/water/distribuitor/
Método: POST
Consume: aplicación/JSON
Produce: aplicación/JSON

Nota: Sección pendiente para actualización a reciente utilización del servicio web.

Demo

Para probar nuestro servicio web descargue un ejemplo de entrada a JSON aquí. (Nueva actualización del ejemplo pendiente).

  1. El servicio puede ser solicitado programaticamente o mediante software cliente con capacidades de solicitud HTTP. Como ejemplo enseñaremos como apelar al servicio web usando la extensión Rest Web Service Client que puede ser instalada en Google Chrome aquí

  2. Una vez integrado a Chrome configure las opciones de solicitud según se indica:
    URL: https://services.cybershare.utep.edu/water/distributor/ Método: POST
    Acepta: aplicación/JSON

  3. Copie el ejemplo entrada de escenario del usuario JSON en el cuerpo de la solicitud.

Captura de pantalla de cliente

  1. Presione el botón "enviar".
  2. Si la ejecución ha tenido éxito el servicio regresara un código 200 con una extensión JSON como respuesta y el atributo del estado como “completo”.

Response Summary

JSON Response

  1. El JSON regresado contendrá atributos adicionales como startedAtTime, endedAtTime y estado.
  2. EL objeto de salida del modelo incluirá el atributo “varValue” que contiene una estructura de datos con resultados generados para cada variable de salida.

Model Output Sample

Actualizaciones Futuras:

  • Mensajes de error JSON para errores internos como:
    • Estructuras JSON invalidas
    • Campos omitidos
    • Valores de parámetro fuera de los límites
  • Modelos de validación del esquema JSON

Referencias

[1] DropWizard - http://www.dropwizard.io/1.1.4/docs/
[2] Maven - https://maven.apache.org/
[2] Gams - El sistema de modelado algebraico general - https://www.gams.com/