Servicios Web
El sistema proveedor de Servicios Web del DOCSE
El DOCSE como Operador del Sistema Eléctrico, pone a su disposición los Servicios Web DOCSE, el cual está compuesto por una serie de servicios WEB, para facilitar la obtención de datos de manera autogestionada. De tal forma de requerirse información de la operación del SEN, ingresando a este sitio, se obtiene un listado de las consultas que se pueden generar de manera automática:
- Generación de energía en un periodo de tiempo
- Demanda de potencia cada 60 minutos
- Potencia máxima
- Niveles de embalse
- Entre otros
Para ingresar a la página de estos servicios siga este enlace o bien digite en su navegador la siguiente dirección:
https://apps.grupoice.com/CenceWeb/paginas/ServiciosWeb.html
En esta página se mostrará la descripción de los servicios que se encuentra disponibles para su autogestión.
Esta página está dividida en 4 secciones:
Los servicios pueden ser accedidos desde diferentes formas:
- Llamado con el URL, desde un navegador web o desde programación.
- Directamente en el sitio CenceWeb: en los pies de página de los gráficos o tablas, se disponen de los enlaces para descargar la información asociada.
- Utilizando la Guía de descarga de Datos Excel.
Para ver un ejemplo detallado de cómo se utilizan los servicios, al final de esta página, se muestran varios ejemplos para su revisión.
Web Services
En esta sección se enlistan los servicios que se encuentra disponibles, en este listado se muestra una categoría, el nombre del servicio y una descripción breve, en la última columna se muestra unos enlaces para llamar el servicio, a modo de ejemplo.
Los servicios están implementados para retornar 3 diferentes formatos: XML, JSON y CSV, según el interés del usuario.
Al ubicar el servicio de interés, se selecciona con el mouse, para que las secciones subsiguientes se actualicen de acuerdo al servicio escogido.
Parámetros
Se muestra el listado de los parámetros que recibe el servicio seleccionado en la sección de Web Services.
En el listado de parámetros se muestra, el nombre, el tipo, la descripción y el valor por defecto, en caso de no incluirse ningún valor en el llamado.
Por ejemplo, para el servicio DemandaMW, están definidos los siguientes parámetros:
Columnas
En esta sección se muestra la descripción del resultado de la consulta con las columnas que las componen.
Por ejemplo, la salida de la consulta al servicio DemandaMW el resultado está compuesto de 3 columnas:
La fecha y hora del dato, la Potencia en MW y la potencia programada en MW.
Variables
Esta última sección corresponde a un listado de variables que se pueden utilizar como parámetro al llamar a un servicio, por ejemplo, se podría solicitar la demanda de AYER al día de HOY.
En el listado se muestra el nombre de la variable, una descripción y el tipo.
Uso de los servicios
Para consultar el servicio de DemandaMW, se tiene
Donde:
- La dirección base del sitio del DOCSE
- Es la ruta para indicar que se trabajarán con los servicios Web
- Es la categoría del servicio
- Es el formato de salida para la consulta
- Nombre del servicio
- Primer parámetro
- Subsiguientes parámetros
Algunos ejemplos de llamados al servicio.
Considerando que la fecha default para el parámetro fin es HOY, este parámetro se puede omitir: