Guides d'installation → Tout le reste

Tout le reste

Il y aura toujours plus d'onduleurs que d'adaptateurs — marques obscures, firmwares anciens, installations hybrides, le Victron de quelqu'un. Plutôt que de vous renvoyer, envoyez les relevés vous-même. Un script shell, une automatisation Home Assistant, un flux Node-RED ou une tâche cron suffisent, et tout le reste fonctionne à l'identique.

Éprouvé sur le terrain

Alimente le site de l'auteur en continu depuis juillet 2026.

À quelle fréquenceAussi vite que vous envoyez

CompatibleTout ce qui sait faire une requête HTTP

Temps d'installationUn après-midi

Le point d'entrée

POST https://api.sunplug.app/ingest/site
Authorization: Bearer <votre clé d'API>
Content-Type: application/json

{
  "tsms": 1785759034000,
  "production_kw": 4.2,
  "net_import_kw": -3.1,
  "consumption_kw": 1.1,
  "battery_discharge_kw": 0.0,
  "battery_soc": 0.62
}

Votre clé se trouve dans l'application, sous Réglages → Équipement → Tout le reste.

Les champs

tsmsMoment du relevé, en millisecondes depuis 1970

production_kwProduction solaire. Toujours positive

net_import_kwRéseau. Positif en soutirage, négatif en injection

consumption_kwToute la maison, recharge des voitures comprise

battery_discharge_kwPositif en décharge, négatif en charge. Optionnel

battery_socUne fraction — 0,62 pour 62 %. Optionnel

La seule chose à ne pas rater

L'injection doit être négative. Tout s'équilibre : consommation = production + réseau + décharge batterie. Inversez le signe du réseau et Sunplug croira que vous soutirez 3 kW par un après-midi ensoleillé et refusera de charger — sans aucune erreur, parce que chaque nombre est individuellement plausible.

Si vous ne pouvez mesurer que deux des trois, envoyez ceux-là et omettez le troisième ; il sera déduit. Envoyer un troisième chiffre faux est pire que de ne rien envoyer.

Un exemple

curl -sS -X POST https://api.sunplug.app/ingest/site \
  -H "Authorization: Bearer $SUNPLUG_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"tsms\": $(date +%s000), \"production_kw\": 4.2,
       \"net_import_kw\": -3.1, \"consumption_kw\": 1.1}"

À quelle fréquence

Toutes les cinq à dix secondes est idéal, et rien en dessous d'une seconde n'apporte quoi que ce soit. Si votre matériel ne peut faire mieux que la minute, envoyez à la minute — Sunplug s'adapte et vous dira simplement que les données sont moins fraîches.

Bloqué ? Écrivez-moi — joignez les logs et je vous dirai ce qu'ils veulent dire.