Une API REST sécurisée, pensée pour vos développeurs
L'interface de programmation de PVReactive suit le style REST (« Representational State Transfer »), le standard le plus répandu du web : des adresses claires, des réponses structurées, et n'importe quel langage de programmation peut l'interroger. L'authentification repose sur OAuth 2 (« Open Authorization »), le standard ouvert d'autorisation sécurisée utilisé par les grandes plateformes du web.
- Données de production : énergie et puissance de chaque site, historique consultable par période.
- Données d'alarmes : alarmes actives et résolues, avec leur sévérité harmonisée entre marques.
- Données de sites : la liste des installations, leurs caractéristiques et leur état.
- Documentation développeur fournie : les points d'accès, les formats et des exemples, accessibles depuis votre espace.
Des webhooks signés pour le temps réel
Interroger l'API convient aux tableaux de bord et aux rapports ; pour les événements, mieux vaut être prévenu que de demander. Les webhooks inversent le sens du dialogue : quand un événement survient — une nouvelle alarme, par exemple — PVReactive notifie directement l'adresse de votre choix, dans vos systèmes.
- Notification en temps réel vers vos propres systèmes, sans interrogation répétée de l'API.
- Messages signés : chaque notification porte une signature cryptographique qui permet à vos systèmes de vérifier qu'elle vient bien de PVReactive et n'a pas été altérée.
- Complémentaires de l'API : le webhook signale l'événement, l'API fournit le détail — le duo classique des intégrations robustes.
Cas d'usage typiques
- Hypervision interne : intégrer la production et les alarmes du parc photovoltaïque dans votre outil de supervision global, aux côtés de vos autres actifs.
- Rapprochement de facturation : croiser automatiquement l'énergie mesurée avec les factures de votre acheteur d'énergie, site par site.
- Outils métier : déclencher un ticket dans votre logiciel d'interventions à chaque nouvelle alarme, alimenter un intranet, nourrir vos rapports internes.
Ce que vous y gagnez
- Zéro double saisie — la donnée mesurée circule d'elle-même jusqu'à vos outils, sans export manuel ni copier-coller.
- Vos outils restent les vôtres — PVReactive alimente votre système d'information au lieu de prétendre le remplacer.
- Des processus proactifs — une alarme qui crée son ticket d'intervention toute seule, c'est un délai de réaction en moins.
- Un accès maîtrisé — authentification standard, périmètre limité à vos données : vos équipes techniques gardent le contrôle.
Comment en profiter ?
L'accès à l'interface de programmation est inclus avec votre abonnement, avec un quota d'appels standard adapté aux usages courants. Pour les volumétries importantes — intégrateurs, hypervision à grande échelle — l'option « Interface de programmation étendue » (+ 990 € par an) multiplie le quota d'appels par dix. La grille complète est affichée sur la page d'accueil.
Questions fréquentes
Faut-il être développeur pour utiliser l'API ?
Pour l'API elle-même, oui — c'est un outil destiné à vos équipes techniques ou à votre intégrateur, avec une documentation développeur pour les guider. Si vous cherchez simplement à consulter vos données, le tableau de bord et les rapports de la plateforme couvrent ce besoin sans écrire une ligne de code.
Comment l'accès est-il sécurisé ?
L'authentification suit le standard OAuth 2 : vos outils obtiennent des jetons d'accès à durée limitée, sans jamais faire circuler de mot de passe, et l'accès reste limité aux données de votre compte. Les webhooks sont signés pour que vos systèmes puissent vérifier l'origine et l'intégrité de chaque notification.
Que se passe-t-il si mon usage dépasse le quota standard ?
Le quota standard couvre les usages courants d'un exploitant. Pour les usages intensifs, l'option « Interface de programmation étendue » multiplie le quota par dix (+ 990 € par an) — et pour un besoin vraiment atypique, écrivez-nous : on regarde ensemble.
Pour aller plus loin : les données exposées par l'API viennent de la supervision multi-constructeurs du parc, et les événements notifiés par webhooks sont ceux des alarmes intelligentes. Notre glossaire explique aussi ce qu'est un système SCADA (« Supervisory Control And Data Acquisition », la supervision industrielle).