Tisk · doporučeno A4 na výšku

4. ID API klíč — podrobný popis

Kapitola 4 · /nastaveni-krok2 · /nastaveni-getkey · /key · /getkey

ID API klíč je licenční / autorizační kód od EaSun (FANET). Bez úspěšného ověření na serveru EaSun běží EaSun Aplikace v omezeném režimu — nastavení často jde, ale měření a plný provoz programu jsou omezené.

Kontakty EaSun (žádost o ID API, obchod, technika):
Web: www.easun.eu · Kontakt · Ceny a prodej
Tel. obchod: +420 736 654 985, +420 722 768 667 · technika: +420 725 581 334
E-mail: fanet@email.cz, obchod@fanet.cz

K čemu ID API slouží

Propojí konkrétní zařízení (ESP MAC uložená při WiFi) s klíčem v databázi EaSun.
Po úspěchu (okeasun) se do SPIFFS zapíše stav ověření a program běží bez omezení.
Ověření vyžaduje přístup na internet (DNS, firewall, žádná izolace klientů WiFi).
Spolu s klíčem se na server posílají jméno, příjmení a e-mail z formuláře WiFi (údaje osoby).

Klíč není „heslo k WiFi“. Je to samostatný kód, který dostanete od EaSun / FANET (programově přidělený, nebo po objednávce / žádosti přes kontakt). Bez klíče aplikaci můžete částečně nastavit, ale funkce zůstanou omezené.

Předpoklady před zadáním klíče

WiFi připojená — zařízení má IP z domácí sítě (ne SoftAP 192.168.4.1, pokud už máte STA).
Internet ven — ESP musí dosáhnout http://api.easun.eu/api/ (HTTPS není v této autorizaci vyžadováno).
Vyplněné údaje osoby při WiFi: jméno, příjmení, funkční e-mail (/EasunData4–6.ea).
Uložená MAC zařízení ve SPIFFS (/keymac.ea) — vzniká při nastavení WiFi; bez ní ověření v průvodci selže.

Kde klíč zadáte

A) Průvodce nastavením (doporučeno při první instalaci)

Položka	Hodnota
Stránka	`/nastaveni-krok2` — „Krok 2: ID API klíč“
Formulář	pole ID API klíč, name `keyapi`, povinné
Placeholder	„Vložte klíč od EaSun / FANET“
Tlačítko	Uložit ID API a autorizovat
Odeslání	GET `/nastaveni-getkey?keyapi=…` (celá stránka, `target="_top"`)

Po odeslání firmware:

Načte klíč z parametru keyapi.
Ověří ho online na AdresaAutorizace = http://api.easun.eu/api/ s parametry IdApi, EspMac, jm, pr, em.
Úspěch (odpověď serveru okeasun): uloží klíč do /key.ea, nastaví /ApiChybaOvereni.ea = 1, posune průvodce na SETUP_KROK = 2 a nabídne pokračování na Krok 3 — MQTT.
Neúspěch: klíč v zařízení nepřepisuje (zůstává původní), krok průvodce se nemění, zobrazí se chybová stránka s tlačítkem „Zpět — znovu zadat ID API“.

B) Plná aplikace (po dokončení průvodce)

Položka	Hodnota
Stránka	`/key`
Formulář	ID API, name `keyapi`
Tlačítko	Autorizovat ID API
Odeslání	GET `/getkey` (skrytý iframe) → zápis `/key.ea`

V plném provozu probíhá periodická / startovní kontrola klíče proti stejnému API. Pokud se nezobrazují hodnoty měření, aplikace sama nabádá požádat o Key ID API nebo otevřít /key.

Co server vrací

Odpověď API	Význam	Důsledek v zařízení
`okeasun`	Klíč platný, autorizace OK	`ApiChybaOvereni = 1` — plný provoz
`delete`	Klíč neplatný / odebrán z databáze	`ApiChybaOvereni = 10` — ověření nefunguje
`remove`	Autorizace zamítnuta	`ApiChybaOvereni = 20` — omezený provoz
jiná / prázdná / chyba sítě	Neočekávaná odpověď nebo timeout	`ApiChybaOvereni = 30` nebo v průvodci jen chybová hláška

Timeout HTTP u ověření v průvodci je cca 15 s, v běžném běhu typicky 10 s. Při chybě DNS / firewallu uvidíte text typu „Nelze spojit se serverem EaSun (síť / DNS / časový limit)“.

Soubory SPIFFS související s ID API

Soubor	Obsah
`/key.ea`	Uložený ID API klíč
`/ApiChybaOvereni.ea`	Stav ověření (1 = OK, 10/20/30 = problém)
`/keymac.ea`	MAC adresa použitá při autorizaci
`/EasunData4.ea` … `6.ea`	Jméno, příjmení, e-mail odesílané s ověřením
`/SETUP_KROK.ea`	Po úspěchu v průvodci hodnota 2

Postup krok za krokem (průvodce)

Na LCD/OLED zkontrolujte IP zařízení v domácí WiFi a otevřete ji v prohlížeči.
V průvodci jděte na Krok 2 (/nastaveni-krok2).
Vložte klíč přesně tak, jak jste ho dostali od EaSun (bez mezer navíc).
Klikněte Uložit ID API a autorizovat a počkejte na výsledek.
Při zeleném „Klíč je platný“ pokračujte na Krok 3 — MQTT.
Při chybě ověřte internet, údaje osoby a klíč; případně kontaktujte EaSun.

Časté problémy

Projev	Co zkontrolovat
Timeout / nelze spojit se serverem	Internet na ESP, DNS, firewall, filtrování HTTP, izolace WiFi klientů
`delete` / klíč neplatný	Překlep v klíči; klíč zrušen — nový klíč přes kontakt
Chybí MAC	Znovu uložte WiFi v průvodci / na `/wifi` a restartujte
Měření se nezobrazují	`ApiChybaOvereni ≠ 1` — otevřete `/key` nebo průvodce Krok 2
Průvodce nejde dál	Bez úspěšného ověření se `SETUP_KROK` na 2 neposune