Llamadas por API de SIPS
  • 16 Sep 2022
  • 1 Minute to read
  • Dark
    Light
  • PDF

Llamadas por API de SIPS

  • Dark
    Light
  • PDF

Article summary

También se pueden realizar búsquedas por API de la siguiente manera:

(En todas las apariciones que se indica TU_TOKEN, es el equivalente al token de identificación que el administrador  ha enviado. Si no lo tiene, debe contacta con el administrador. Es obligatorio en todas las peticiones de la API, sin él, no habrá acceso a los datos del Sips).

1. Obtener los datos de un suministro:

Para obtener los datos de un suministro se tiene que realizar la siguiente llamada:

  • http://xxxx-sips.nemon2ib.com/sips-api/detail/request/TU_TOKEN/token/CUPS_A_OBTENER/cups/

Por ejemplo, si queremos obtener los datos del suministro ES0033770545886001AG0F, la llamada se realizará a la siguiente url: http://xxxx-sips.nemon2ib.com/sips-api/detail/request/ES0033770545886001AG0F/cups/ La petición devolverá un json con los datos del suministro indicado. Si no encuentra el suministro, devolverá un json vacío.

 

2. Obtener un listado de suministros

Para obtener un listado de suministros se tiene que realizar la siguiente llamada:

  • http://xxxx-sips.nemon2ib.com/sips-api /list/request/TU_TOKEN/token/FILTROS

Algunos ejemplos de llamadas con filtros: 

Listado de tarifas 2.0TD de Tarragona. http://xxxx-sips.nemon2ib.com/sips-api/list/request/a16s5d1as6d5sd65a1sd6/token/2.0TD/tariff/Tarragona/city/ 

Listado de potencias contratadas entre 0 y 3000, del código postal 48001. http://xxxx-sips.nemon2ib.com/sips-api/list/request/a16s5d1as6d5sd65a1sd6/token/48001/postalcode/0/minpotence/3000/maxpotence/

 Listado de FILTROS:

  • Tarifa

Se puede filtrar los datos del listado por una tarifa. El formato del filtro es: NOMBRE_TARIFA/tariff/

Dónde NOMBRE_TARIFA es un nombre de la siguiente lista:

  • 2.0A
  • 2.1A
  • 2.0DHA
  • 2.1DHA
  • 2.0DHS
  • 2.1DHS
  • 3.0A
  • 3.1A
  • 6.1A
  • 6.2
  • 6.3
  • 6.4
  • 6.1B
  • 6.5
  • 2.0TD
  • 6.1TD 
  • 6.2TD 
  • 6.3TD 
  • 6.4TD
  • 3.0TDVE
  • 6.1TDVE
  • 2.0TDA
  • 3.0TDA 
  • 6.1TDA
  • 6.2TDA
  • 6.3TDA
  • 6.4TDA
  • Código Postal

Se puede filtrar los datos del listado por un código postal. El formato del filtro es: CODIGO_POSTAL/postalcode/

Dónde CODIGO_POSTAL es el código postal por el cual se desea filtrar los resultados.

  • Localidad

Se puede filtrar los datos del listado por la localidad. El formato del filtro es: LOCALIDAD/city/

Dónde LOCALIDAD es la localidad por la cual se desea filtrar los resultados. Los resultados se filtrarán de modo que, filtrando por la localidad "AN", te aparecerán todos los suministros que la localidad contiene la cadena AN (por ejemplo, Ana, anual, Aran...).

  • Potencia contratada

Se puede filtrar los datos del listado por la potencia mínima y máxima contratada. El formato del filtro es: POTENCIA_MINIMA/minpotence/POTENCIA_MAXIMA/maxpotence/ 

Dónde POTENCIA_MINIMA es la potencia mínima contratada por la cual se desea filtrar los resultados y POTENCIA_MAXIMA es la potencia máxima contratada por la cual se desea filtrar los resultados. El valor mínimo, en los dos casos, es de 0.