Servicios Web

Guía del sistema proveedor de Servicios Web del CENCE.

El sistema proveedor de Servicios Web del CENCE

El CENCE como Operador del Sistema Eléctrico Nacional, pone a su disposición los Servicios Web CENCE, 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:

  1. La dirección base del sitio del CENCE
  2. Es la ruta para indicar que se trabajarán con los servicios Web
  3. Es la categoría del servicio
  4. Es el formato de salida para la consulta
  5. Nombre del servicio
  6. Primer parámetro
  7. Subsiguientes parámetros


Algunos ejemplos de llamados al servicio.

  • Para consultar la demanda de potencia en formato XML, con los parámetros default:
  • https://apps.grupoice.com/CenceWeb/data/sen/xml/DemandaMW

  • Para consultar la demanda de potencia en formato JSon, con los parámetros default:
  • https://apps.grupoice.com/CenceWeb/data/sen/json/DemandaMW

  • Para consultar la demanda de potencia en formato CSV, con los parámetros default:
  • https://apps.grupoice.com/CenceWeb/data/sen/csv/DemandaMW

  • Para consultar la demanda de potencia del primer mes del 2021 en formato JSon, podría realizarse con el siguiente llamado:
  • https://apps.grupoice.com/CenceWeb/data/sen/json/DemandaMW?inicio=20210101&fin=20210131

  • Para usar las variables simplemente se sustituyen en el parámetro de interés, respetando que el tipo de parámetros sea del mismo tipo de la variable, por ejemplo, para obtener los datos a partir del inicio de la semana (lunes) al día de hoy, se puede utilizar la variable PRIMER_DIA_SEMANA como inicio y la variable HOY como fin:
  • https://apps.grupoice.com/CenceWeb/data/sen/json/DemandaMW?inicio=PRIMER_DIA_SEMANA&fin=HOY

    Considerando que la fecha default para el parámetro fin es HOY, este parámetro se puede omitir:
    https://apps.grupoice.com/CenceWeb/data/sen/json/DemandaMW?inicio=PRIMER_DIA_SEMANA