currencylayer

Co umí

Služba poskytuje kurzy pro přibližně 170 měn. Bezplatný účet má omezení na základní měnu USD, 250 požadavků měsíčně a denní aktualizace.

V RichPear Home vznikne senzor pro zvolený pár měn nebo více cílových měn podle položky quote.

Příprava

RichPear Home v místní síti otevřete na http://rphome.local:8123. Pokud místní název v dané síti neodpoví, použijte http://IP-ADRESA:8123.

Založte si účet u Currencylayer a připravte API klíč. Rozhodněte, jakou základní měnu použijete a které cílové měny chcete sledovat. U bezplatného účtu počítejte s omezením základní měny na USD.

Nastavení

Tato integrace se nastavuje ručně v konfiguraci. Po úpravě YAML ověřte syntaxi, restartujte systém a až potom kontrolujte vytvořené entity.

sensor:
  - platform: currencylayer
    api_key: YOUR_API_KEY
    base: USD
    quote:
      - EUR
      - CZK

Položka api_key je povinná. base určuje základní měnu a quote jednu nebo více cílových měn.

Kontrola

Po restartu otevřete seznam entit a ověřte, že kurzové senzory mají číselnou hodnotu. Pokud je hodnota neznámá, zkontrolujte API klíč, limity účtu a kódy měn.

U finančních dashboardů zobrazujte i čas poslední aktualizace nebo stav entity, aby bylo jasné, zda jde o čerstvá data.

Automatizace

Kurzové senzory používejte pro orientační výpočty, upozornění a přehledy. Pro finančně závazné rozhodování ověřujte data proti primárnímu zdroji.

Upozornění stavte s hysterzí, aby drobné kurzové pohyby neposílaly příliš mnoho oznámení.

Provoz

Sledujte měsíční limit API. Pokud máte více kurzů, držte konfiguraci úspornou a nepřidávejte měny, které reálně nepoužíváte.

Změnu měn provádějte v YAML a po úpravě restartujte systém.

Řešení problémů

Chyba autentizace obvykle znamená špatný API klíč nebo neaktivní účet. Chybějící kurz může znamenat neplatný symbol měny nebo omezení tarifu.

Pokud data přestanou chodit po delší době provozu, zkontrolujte limit požadavků a stav služby Currencylayer.