Pour développeurs & intégrateurs domotiques

API NRGkick : connectez votre câble de recharge à votre maison intelligente

Grâce à l’API locale du NRGkick, vous intégrez votre câble de recharge directement dans votre système de maison intelligente et programmez vos propres automatisations. Contrairement à l’application, l’API vous permet de récupérer des données encore plus précises et de piloter le processus de charge de manière entièrement automatique.

Demandez votre devis
Découvrez le NRGkick

Qu’est-ce qu’une API locale ?

Une API (Application Programming Interface) est un ensemble de commandes permettant à deux appareils d’échanger directement des informations. Chaque requête a une réponse prédéfinie — aucune donnée ne peut être envoyée en dehors de ces commandes fixées, ce qui rend l’intégration à la fois puissante et sûre. L’API locale du NRGkick est disponible en deux protocoles, chacun avec ses propres avantages.

API JSON

Une API REST locale qui renvoie des informations via des endpoints clairs, comme GET /info pour les données de l’appareil (numéro de série, adresse MAC) et GET /values pour les données de mesure en temps réel (puissance, énergie, températures). Idéal lorsque vous souhaitez lire des données rapidement et facilement.

API Modbus

Fonctionne avec des adresses mémoire individuelles plutôt qu’avec des endpoints groupés. Tous les registres utilisent le format little-endian et sont interrogeables via l’Unit ID 1. L’avantage : vous demandez exactement les valeurs dont vous avez besoin, sans envoyer de données superflues.

Plus de possibilités que l’application

Là où dans l’application NRGkick vous devez vous-même adapter activement votre courant de charge, l’API vous permet d’automatiser cela entièrement. Vous construisez ainsi votre propre logique basée sur des données en temps réel — par exemple pour ajuster automatiquement en fonction de la production de vos panneaux solaires ou de votre consommation électrique domestique totale.

  • Données plus précises et détaillées que via l’application
  • Entièrement automatisable, aucune intervention manuelle nécessaire
  • Deux protocoles : API JSON et API Modbus TCP
  • Authentification BasicAuth optionnelle pour une sécurité supplémentaire
  • Documentation officielle complète disponible

Tout ce que vous devez savoir sur l’API NRGkick

De l’activation aux applications concrètes : retrouvez ici tous les détails techniques sur l’API locale.

Vous devez d’abord activer l’API locale via l’application NRGkick. Ouvrez l’application, connectez-vous à votre appareil, allez dans Paramètres → API JSON, et activez l’API. Vous pouvez éventuellement configurer directement ici une authentification BasicAuth, afin que seuls les appareils autorisés aient accès à votre NRGkick. Pour l’API Modbus, une activation similaire s’applique via les paramètres de l’application.

L’endpoint GET /info renvoie des données d’identification telles que le numéro de série et l’adresse MAC, avec lesquelles vous identifiez de manière unique votre appareil au sein de votre système. L’endpoint GET /values fournit une télémétrie en temps réel : puissance actuelle, énergie consommée et mesures de température. Les deux endpoints peuvent également être interrogés par section, de sorte que vous ne receviez que les données dont vous avez besoin — pratique si vous souhaitez limiter la charge sur votre propre système.

L’API Modbus fonctionne via des adresses de registre numérotées plutôt que via des endpoints. Tous les registres utilisent le format little-endian et sont interrogeables via l’Unit ID 1. Important : les adresses doivent toujours être lues avec leur longueur de registre correcte ; tant que vous respectez le bon alignement, vous pouvez également lire plusieurs adresses simultanément. Ce protocole est particulièrement intéressant pour l’intégration avec des systèmes industriels de gestion de l’énergie qui utilisent déjà Modbus en standard.

Grâce à l’API JSON ouverte et documentée, il existe même une bibliothèque Python open-source avec laquelle les développeurs connectent directement leur NRGkick à Home Assistant, une plateforme domotique open-source populaire. Cela illustre parfaitement la puissance de l’API locale : vous n’êtes pas limité à l’application officielle NRGkick, mais pouvez vous-même (ou via votre intégrateur domotique) créer des automatisations entièrement sur mesure.

L’API constitue la base idéale pour automatiser encore davantage la recharge solaire : au lieu de vous fier aux stratégies de charge fixes de l’application, vous lisez en temps réel via l’API votre production d’énergie solaire et ajustez vous-même le courant de charge. Si vous gérez plusieurs points de charge ou de gros consommateurs, l’API constitue également la base technique de notre système de gestion des pics de charge, et s’intègre parfaitement aux intégrations de réseaux de recharge OCPP pour les gestionnaires de flotte.

Vous souhaitez utiliser l’API NRGkick ?

Contactez-nous pour la documentation technique complète, ou demandez directement votre devis.