API de consulta individualizada
Disponibilidad y consultas masivas
Este servicio no está pensado para sustituir a la descarga de los ficheros por lo que su disponibilidad no está garantizada. Las herramientas de prevención de ataques masivos pueden llegar a bloquear las peticiones muy frecuentes. Recordamos a las comercializadoras que, en cualquier caso, los datos están disponibles en el fichero de descarga.
Los usuarios autorizados para realizar descargas de ficheros pueden utilizar el siguiente API para la descarga de datos parciales, indicando los CUPS que se desean.
https://api.cnmc.gob.es/verticales/v1/SIPS/consulta/v1/<TIPO_FICHERO>.csv?cups=<CUPS, separados por coma>
Los tipos de fichero disponibles son los mismos que en la descarga:
- SIPS2_PS_ELECTRICIDAD
- SIPS2_CONSUMOS_ELECTRICIDAD
- SIPS2_PS_GAS
- SIPS2_CONSUMOS_GAS
El resultado es un fichero CSV con la misma estructura de los generados mensualmente.
Los datos proceden del último periodo cerrado.
Las peticiones a los servicios de consulta inidividualizada no están incluidos en la interfaz del "Cliente web de carga y descarga", por lo que utilizar la Autenticación de API con OAuth no es inmediato, como la Autenticación con certificado.
Para poderla utilizar se puede utilizar un programa gratuito como POSTMAN (https://www.getpostman.com/) que permite incluir credenciales OAuth en las peticiones.
Este sería un ejemplo de configuración para la consulta de los datos del punto de suministro eléctrico por su CUPS:
Hay varios puntos a tener en cuenta:
- Introducir la URL incluyendo los CUPS que queremos consultar
- Seleccionar OAuth 1.0 como método de autenticación
- Introducir las claves OAuth proporcionadas para el procedimiento concreto
- Marcar para agregar los parámetros de securización a la cabecera de la petición
- Recordar que no es necesario rellenar los parámetros temporales puesto que el programa (como lo indica en la propia pantalla) lo rellena automáticamente
- Pulsar el botón que actualiza la solicitud, por si estamos realizando varias solicitudes desde la misma pantalla
- Enviar la solicitud al servidor
- El resultado se muestra en la zona inferior de la pantalla y puede guardarse como CSV