Inicio " Uso de los datos de SolarAnywhere " API de SolarAnywhere " API sincrónica en tiempo real (Beta)

API sincrónica en tiempo real (Beta)

Los datos de SolarAnywhere® ya están disponibles en una nueva API de monitorización en versión beta. Los puntos síncronos de la API admiten una recuperación de datos rápida y fiable sin comprometer la calidad de los datos.

¿Por qué es importante para el sector de las energías renovables?

La gestión de activos de energías renovables es cada vez más digital gracias a la adopción de nuevas tecnologías de supervisión. Además el bajo rendimiento sistémico de las plantas solares ha hecho que los gestores de activos se centren más en la evaluación comparativa del rendimiento y la reducción de las deficiencias operativas. Sin embargo, la falta de datos, la cobertura inadecuada, la mala calidad de los datos o la alta latencia de las fuentes de datos son obstáculos importantes para las operaciones.

Los datos meteorológicos y de irradiancia en tiempo real de SolarAnywhere, a través de una API síncrona, permiten identificar rápidamente los casos de bajo rendimiento y refuerzan la resistencia de las canalizaciones de datos necesarias para la gestión moderna de activos.

La nueva API de supervisión es idónea para casos de uso como:

  • Control del rendimiento solar en tiempo real
  • Comparación de sus activos solares globales con el potencial solar total para identificar áreas de mejora
  • Identificar los verdaderos malos resultados frente a las desviaciones naturales
  • Integración de SCADA y cuadros de mando
  • Rellenar los datos de los instrumentos que falten o estén defectuosos para garantizar un seguimiento y análisis continuos
  • Integración con modernos sistemas de vigilancia
  • Datos muy fiables con actualizaciones frecuentes cada menos de una hora.

Pruebe la API síncrona

El acceso a la beta de la API sincrónica está disponible con una licencia de SystemCheck®y puede activarse en cualquier momento. Póngase en contacto con support@solaranywhere.com para probar la nueva API hoy mismo.

Si eres un administrador de licencias (aprende más sobre los roles de usuario de SolarAnywhere aquí) en tu cuenta SolarAnywhere, puedes crear un cliente API navegando a la página Licencia después de iniciar sesión y siguiendo estas instrucciones:

  1. Desplácese hasta la sección "Gestión de clientes de la API".
  2. Seleccione "Synchronous API (Beta)" y espere a que aparezca la ventana emergente
    (Nota: el botón "Asynchronous API" crea claves API para todos los productos de datos SolarAnywhere con licencia).
  3. Escriba un nombre en el cuadro de texto (el nombre no hace nada; es sólo un identificador útil)
  4. Haga clic en "Confirmar" para crear su clave API
  5. Almacenar de forma segura la clave API que se le proporciona en la ventana emergente
    (Nota: no almacenamos su clave API, por lo que no podemos regenerarla en su nombre).

Deberá enviar una clave de API sincrónica válida con cada solicitud. La clave debe incluirse como cabecera de solicitud con el siguiente formato:

"X-Api-Key": "[Clave API de 64 caracteres]"

A continuación encontrará ejemplos de uso de la clave API en Postman y la documentación completa sobre la API sincrónica:

Documentación de la API

Otros datos técnicos

¿En qué se diferencia la API sincrónica de SolarAnywhere?

La API sincrónica de SolarAnywhere agiliza la automatización y recuperación de datos meteorológicos y de irradiancia mediante una arquitectura en la nube sin servidores. En otras palabras, las solicitudes se distribuyen entre el vasto conjunto de recursos informáticos. Esta arquitectura, unida a un diseño optimizado, aporta notables ventajas de rendimiento:

  • Optimización de la recuperación de datos a corto plazo (desde ahora hasta las últimas 48 horas) y de las llamadas de alta frecuencia.
  • Fuerte escalado de la carga
  • Menor dispersión de la latencia de la API para un rendimiento fiable

Esta API también mejora la experiencia del usuario mediante:

  • Carga útil de datos racionalizada para un tratamiento más eficaz
  • Entrega de datos JSON para facilitar el análisis sintáctico
  • Definiciones simplificadas de los parámetros

¿Por qué Beta?

La API síncrona estará en fase beta durante varios meses para que podamos recoger comentarios y escuchar a los clientes. Mientras esté en estado beta, la API está sujeta a cambios y no se recomienda para entornos de producción. Algunos ejemplos de cambios pueden ser la denominación de los campos o la organización de los puntos finales. Una vez que la API salga de la fase beta, los parámetros no cambiarán y será versionada y estable para producción.

SolarAnywhere recopilará comentarios para mejorar la API sincrónica con el fin de prestar un mejor servicio a los clientes en el futuro.

Síncrono frente a asíncrono: ¿cuándo usar uno u otro?

En una API síncrona, el cliente hace una petición al servidor y espera una respuesta antes de continuar, mientras que en una API asíncrona, la información debe obtenerse en una petición separada. Como las respuestas suelen ser rápidas, las API síncronas son más eficaces cuando es necesario intercambiar datos operativos con gran frecuencia y fiabilidad. En cambio, las API asíncronas son excelentes para grandes volúmenes de entrega de datos o aplicaciones de cálculo intensivo en las que los tiempos de procesamiento pueden variar.

La mejor API a utilizar -sincrónica o asincrónica- depende en gran medida del caso de uso final. En el caso de los patrones de llamada aleatorios y de alta frecuencia (habituales en las interfaces de usuario), la API síncrona presenta claras ventajas. Sin embargo, para aplicaciones intensivas en datos que se actualizan periódicamente (común en los informes mensuales), la API asíncrona podría ser mejor. La API sincrónica también cubre tipos de datos selectos (por ahora) mientras que la API asincrónica soporta el conjunto completo de servicios de datos de SolarAnywhere.

Si desea orientación sobre la implementación de datos SolarAnywhere a escala, póngase en contacto con nuestro equipo de asistencia técnica o envíe un correo electrónico a support@solaranywhere.com.

Tabla 1: Comparación de las API de SolarAnywhere

*La resolución espacialdepende de los satélites: consulte Cobertura geográfica para obtener más información.
**La limitaciónpuede adaptarse a cada usuario: póngase en contacto con support@solaranywhere.com.

Calidad y fuentes de datos

Los puntos finales síncronos de la API permiten una recuperación de datos rápida y fiable sin comprometer la calidad de los datos. Como puede verse en la tabla siguiente, las fuentes de datos de cada API se rigen por las mismas normas de calidad.

Consulte nuestra Documentación API para conocer las especificaciones más actualizadas.

Tabla 2: Fuentes API síncronas y asíncronas y campos de datos

Rendimiento, escalabilidad y estrangulamiento

La API síncrona está diseñada para ofrecer escalabilidad y baja latencia. Esto significa que los usuarios pueden esperar una respuesta fiable en cuestión de segundos. Los resultados de nuestras pruebas de escalabilidad muestran que más del 99% de las llamadas se completan en menos de 2000 ms (2 segundos).1 Para mantener un rendimiento fiable para todos los usuarios, la API síncrona tiene un límite de limitación por defecto (actualizado en la Tabla 1). Contacto support@solaranywhere.com si necesita ajustar este límite.


1 El rendimiento real de la API varía. Los resultados aquí mostrados representan únicamente el rendimiento objetivo, no el rendimiento garantizado para los usuarios.