Jak získat token v SolaX Cloud

Token je způsob, jak dát nějaké službě přístup ke čtení dat z vaší elektrárny, aniž byste jí dávali heslo od účtu. U SolaXu si ho vygenerujete sami v portálu, je zdarma a zabere to minutu.

Tenhle návod popisuje, kde ho vzít, co se s ním dá a nedá dělat a jaká má omezení — včetně těch nepříjemných, o kterých je lepší vědět předem.

Co budete potřebovat

Dva údaje. Zaměňují se překvapivě často, takže rovnou rozdíl:

Registrační číslo NENÍ sériové číslo střídače. Je to číslo té malé krabičky, která je do střídače zastrčená a stará se o připojení k internetu. Zadání sériového čísla střídače je zdaleka nejčastější důvod, proč připojení neprojde.

Postup

1. Přihlaste se do SolaX Cloud — přes web nebo mobilní aplikaci, stejnými údaji, jaké používáte na sledování výroby.
2. Otevřete sekci Service → API a vygenerujte token (tokenId).
3. Najděte registrační číslo komunikačního modulu — je na jeho štítku a také v seznamu zařízení ve vašem účtu.

Pokud se vám sekce nezobrazuje na stejném místě, nezoufejte: SolaX Cloud běží ve více regionálních instancích (global.solaxcloud.com, www.solaxcloud.com a další) a rozhraní se mezi nimi i mezi verzemi liší. Hledejte položku pojmenovanou „API" nebo „Token" v nastavení účtu či služeb.

Co token umí a co ne

Tohle je část, kterou většina návodů vynechává, a přitom rozhoduje o tom, co od připojení čekat.

Umí: přečíst aktuální stav elektrárny — okamžitý výkon, dnešní a celkovou výrobu, výkon jednotlivých větví panelů, stav baterie, toky do sítě a ze sítě a stavový kód střídače.

Neumí: vytáhnout historii. Uživatelské API SolaXu žádnou nevrací — ověřeno v dokumentaci obou verzí (User Monitoring API V6.1 i User API V2.0). To má přímý důsledek pro každou službu, která přes token pracuje: výrobu za období musí počítat z rozdílu dvou čtení, což znamená, že hodnota začíná dnem připojení a roste s časem. Kdo slibuje, že vám z tokenu okamžitě ukáže loňský rok, buď to bere odjinud, nebo to není pravda.

Jedna výjimka: střídač si vede kumulativní počítadla od instalace (celková výroba, celkem do sítě, celkem ze sítě). Z nich se dá hned po prvním čtení udělat hrubá celoživotní bilance — ale je to průměr za celý provoz, ne historie po měsících, a podle toho se s ním musí zacházet (viz celoživotní odhad výroby z jednoho čtení).

Limity: 10 dotazů za minutu a 10 000 za den na token. Pro sledování elektrárny je to bohatě dost; znamená to jen, že se čte periodicky, ne nepřetržitě.

Bezpečnost — co si ohlídat

• Token je přístupový údaj. Zacházejte s ním jako s heslem: neposílejte ho v nešifrované zprávě a nezveřejňujte ve fotce obrazovky.
• Dává jen čtení. Přes tuhle cestu nejde střídač ovládat ani měnit nastavení — to je vlastnost API, ne slib.
• Přístup končí tam, kde vznikl. Token vydal váš účet v SolaX Cloud a jeho správa zůstává tam.
• Nikdy nedávejte nikomu heslo k účtu místo tokenu. Rozdíl mezi tokenem a heslem je právě v tom, co všechno umožňují.

Jak to funguje u nás

Když token a registrační číslo zadáte na stránce připojit SolaX, stane se tohle:

• Údaje se zašifrují a uloží; token se nikdy nevrací zpátky do prohlížeče ani neputuje v adrese stránky.
• Uděláte první čtení a hned uvidíte aktuální stav elektrárny.
• Dál čteme automaticky několikrát denně. Vy už nemusíte dělat nic.
• Dostanete odkaz na report. Uložte si ho — je to vaše cesta zpátky k výsledku.

Co přibývá v čase, protože historie se musí naměřit:

Co poznáme hned od začátku bez ohledu na historii: poruchu, kterou střídač hlásí sám o sobě, a odpojenou nebo vadnou baterii. Tyhle nálezy nic neodvozují z výroby, takže nepotřebují žádnou nasbíranou řadu — viz stavové kódy střídače.

Když připojení neprojde

Tři nejčastější příčiny v pořadí:

1. Zadané sériové číslo střídače místo registračního čísla modulu. Viz výše — je to zdaleka nejčastější.
2. Token z jiné regionální instance. Účet na www.solaxcloud.com a účet na global.solaxcloud.com nejsou totéž.
3. Překlep při opisování. Token je dlouhý; kopírujte, nepřepisujte.

Nemáte SolaX?

Zatím umíme číst jenom jeho. Ostatní značky se liší dost zásadně — u některých je token stejně dostupný, u jiných je API zamčené za instalatérem nebo za smlouvou. Rozdíly jsme sepsali ve srovnání které značky střídačů vás pustí k vlastním datům.

Mezitím funguje rychlá kontrola i bez připojení — stačí opsat pár čísel z aplikace, kterou už máte.