Accueil " Utiliser les données de SolarAnywhere " API SolarAnywhere " API synchrone en temps réel (Beta)

API synchrone en temps réel (Beta)

Les données SolarAnywhere® sont désormais disponibles en version bêta dans une API synchrone rationalisée et en temps réel ! Les points API synchrones permettent une récupération rapide et fiable des données sans en compromettre la qualité. Plus d'informations ci-dessous.

Pourquoi est-ce important pour l'industrie des énergies renouvelables ?

La gestion des actifs des énergies renouvelables devient de plus en plus numérique avec l'adoption de nouvelles technologies de surveillance. En outre, la gestion des actifs des énergies renouvelables devient de plus en plus numérique avec l'adoption de nouvelles technologies de surveillance, la sous-performance systémique des centrales solaires a renforcé l'intérêt des gestionnaires d'actifs pour l'étalonnage des performances et le comblement des lacunes opérationnelles. Cependant, les données manquantes, la couverture inadéquate, les données de mauvaise qualité ou les flux de données à forte latence constituent des obstacles importants aux opérations.

Les données météorologiques et d'irradiation en temps réel de SolarAnywhere, via une API synchrone, permettent d'identifier rapidement les performances insuffisantes et renforcent la résilience des pipelines de données nécessaires à la gestion moderne des actifs.

L'API en temps réel est bien adaptée à des cas d'utilisation tels que :

Contrôle de la performance solaire en temps réel

  • Analyse comparative de vos actifs solaires mondiaux par rapport au potentiel solaire total afin d'identifier les domaines d'amélioration
  • Calculer les principales mesures de suivi de l'énergie solaire pour les rapports, comme le ratio de performance (PR).
  • Identifier les véritables sous-performances par rapport aux écarts naturels

Intégration SCADA et tableaux de bord

  • Remplir les données manquantes ou défectueuses des instruments afin d'assurer une surveillance et une analyse continues
  • Intégration dans les systèmes de surveillance modernes
  • Fournir des données très fiables avec des mises à jour fréquentes, inférieures à l'heure.

Essayez l'API synchrone

L'accès à la version bêta de l'API synchrone est disponible avec une licence SystemCheck®et peut être activé à tout moment. Contactez support@solaranywhere.com pour tester la nouvelle API dès aujourd'hui.

Si vous êtes un gestionnaire de licence (en savoir plus sur les rôles des utilisateurs SolarAnywhere ici) sur votre compte SolarAnywhere, vous pouvez créer un client API en naviguant vers la page Licence après vous être connecté et en suivant ces instructions :

  1. Faites défiler vers le bas jusqu'à la section intitulée "Gestion du client API".
  2. Sélectionnez "Synchronous API (Beta)" et attendez le pop-up
    (Note : le bouton "Asynchronous API" crée des clés API pour tous les produits de données SolarAnywhere sous licence).
  3. Tapez un nom dans la zone de texte (le nom ne sert à rien, c'est juste un identifiant utile).
  4. Cliquez sur "Confirmer" pour créer votre clé API
  5. Stocker en toute sécurité la clé API qui vous a été communiquée dans la fenêtre contextuelle
    (Remarque : nous ne stockons pas votre clé API et ne pouvons donc pas la régénérer en votre nom).

Vous devrez soumettre une clé d'API synchrone valide avec chaque demande. La clé doit être incluse dans un en-tête de requête au format suivant :

X-Api-Key' : "[Clé d'API de 64 caractères]"

Des exemples d'utilisation de la clé API dans Postman et la documentation complète de l'API synchrone sont disponibles ci-dessous :

Documentation de l'API

Autres détails techniques

En quoi l'API synchrone de SolarAnywhere est-elle différente ?

L'API synchrone de SolarAnywhere rationalise l'automatisation et la récupération des données d'irradiation et météorologiques en utilisant une architecture cloud sans serveur. En d'autres termes, les demandes sont réparties sur un vaste ensemble de ressources informatiques plutôt que sur un nombre limité de serveurs. Cette architecture, associée à une conception rationalisée, permet d'obtenir des avantages notables en termes de performances :

  • Optimisation de l'extraction des données à court terme (jusqu'à 48 heures) et des appels à haute fréquence
  • Forte mise à l'échelle de la charge
  • Diminution du temps de latence de l'API pour des performances fiables

Cette API améliore également l'expérience de l'utilisateur :

  • Des charges utiles de livraison de données rationalisées pour un traitement plus efficace
  • Livraison de données JSON pour une analyse facile
  • Définitions simplifiées des paramètres

Pourquoi Beta ?

L'API synchrone sera en version bêta pendant plusieurs mois afin que nous puissions recueillir des commentaires. commentaires et d'écouter les clients. Pendant cette période, l'API est sujette à des modifications et n'est pas recommandée pour les environnements de production. Les changements peuvent concerner, par exemple, la dénomination des champs ou l'organisation des points de terminaison. Une fois que l'API aura quitté la phase bêta, les paramètres ne changeront pas et seront versionnés et stables pour la production.

SolarAnywhere recueillera des commentaires pour améliorer l'API synchrone afin de mieux servir les clients à l'avenir.

Synchrone ou asynchrone : quand utiliser quoi ?

Dans une API synchrone, un client adresse une demande au serveur et attend une réponse avant de poursuivre, tandis que dans une API asynchrone, les informations doivent être récupérées dans une demande distincte. Les réponses étant généralement rapides, les API synchrones sont les plus efficaces lorsque des données opérationnelles doivent être échangées à une fréquence et avec une fiabilité élevées. En revanche, les API asynchrones sont excellentes pour la livraison de gros volumes de données ou pour les applications à forte intensité de calcul où les temps de traitement peuvent varier.

La meilleure API à utiliser - synchrone ou asynchrone - dépend fortement du cas d'utilisation final. Pour les appels aléatoires à haute fréquence (courants dans les interfaces utilisateur), l'API synchrone présente des avantages évidents. Toutefois, pour les applications à forte intensité de données qui sont mises à jour périodiquement (comme les rapports mensuels), l'API asynchrone peut s'avérer plus appropriée. L'API synchrone couvre également certains types de données (pour l'instant), tandis que l'API asynchrone prend en charge l'ensemble des services de données de SolarAnywhere.

Si vous souhaitez obtenir des conseils sur la mise en œuvre des données SolarAnywhere à grande échelle, veuillez contacter notre équipe de support technique ou envoyer un e-mail à support@solaranywhere.com.

Tableau 1 : Comparaison côte à côte des API de SolarAnywhere

*La résolution spatialedépend du satellite - voir la couverture géographique pour plus de détails.
**Le ralentissementpeut être adapté à chaque utilisateur - contacter support@solaranywhere.com.

Qualité et sources des données

Les points d'extrémité synchrones de l'API permettent une récupération rapide et fiable des données sans en compromettre la qualité. Comme le montre le tableau ci-dessous, les sources de données derrière chaque API sont soumises aux mêmes normes de qualité des données.

Voir notre Documentation API pour les spécifications les plus récentes.

Tableau 2 : Sources API synchrones et asynchrones et champs de données

Performance, évolutivité et étranglement

L'API synchrone est conçue pour l'évolutivité et la faible latence. Cela signifie que les utilisateurs peuvent s'attendre à une réponse fiable en quelques secondes. Les résultats de nos tests d'évolutivité montrent que plus de 99 % des appels sont effectués en moins de 2 000 ms (2 secondes).1 Pour que les performances restent fiables pour tous les utilisateurs, l'API synchrone dispose d'une limite d'étranglement par défaut (mise à jour dans le tableau 1). Contact support@solaranywhere.com si vous avez besoin d'ajuster cette limite d'étranglement.


1 Les performances réelles de l'API varient. Les résultats indiqués ici représentent uniquement des performances cibles, et non des performances garanties pour les utilisateurs.