Integrace RichPear Home
Nederlandse Spoorwegen (NS)
Nederlandse Spoorwegen (NS) poskytuje reálné informace o nizozemských vlakových spojích, odjezdech, zpožděních a trasách pomocí NS API.
- Doména
nederlandse_spoorwegen- Kategorie
- Doprava
- Komunikace
- cloud-polling
- Kvalita
- Není uvedeno
Příprava
Nejdřív připravte vše, co integrace Nederlandse Spoorwegen (NS) potřebuje mimo RichPear Home: API klíč z NS API portálu pro Reisinformatie API a připravené stanice nebo trasy, které chcete sledovat. Bez této přípravy se průvodce může dokončit jen částečně nebo se entity budou tvářit jako nedostupné.
Uživatelé obvykle otevírají systém na http://rphome.local:8123. Pokud tato adresa nefunguje, použijte http://IP-ADRESA:8123. Nastavení provádějte z účtu správce, aby bylo možné vytvářet zařízení, oblasti a případné pomocné entity.
Nastavení
V RichPear Home otevřete Nastavení -> Zařízení a služby, zvolte Přidat integraci a vyhledejte Nederlandse Spoorwegen (NS). Pokud je zařízení nebo služba nalezená automaticky, dokončete nabídnuté nastavení z objevené karty.
Průvodce obvykle vyžaduje přihlašovací údaje, API klíč, adresu zařízení nebo výběr konkrétního účtu podle typu integrace. Zadejte API klíč a vytvořte sledované trasy. Po dokončení zkontrolujte, zda senzory ukazují správnou výchozí a cílovou stanici. Po dokončení pojmenujte zařízení podle místnosti a zkontrolujte, že vytvořené entity odpovídají skutečnému zařízení nebo službě.
API klíč
Pro integraci je potřeba klíč z NS API portálu. Požádejte o přístup k Reisinformatie API v rámci odpovídajícího produktu.
Klíč ukládejte bezpečně a při podezření na únik ho v portálu vyměňte. Bez platného klíče se data nebudou aktualizovat.
Trasy
Sledovaná trasa má výchozí a cílovou stanici. Pro každodenní cestu tam i zpět vytvořte samostatné položky, protože směr a časy se liší.
Názvy stanic zadávejte podle NS dat. Pokud se stanice nenajde, ověřte oficiální zkratku nebo přesný název v API.
Konkrétní vlak
Integrace může pracovat s nejbližším vlakem nebo s konkrétnějším vyhledáním podle potřeby. Pro běžné dojíždění je většinou lepší nejbližší relevantní spoj.
Pokud chcete sledovat konkrétní vlak, připravte si logiku pro dny, kdy vlak nejede nebo má mimořádnost.
Zpoždění a data
Data pocházejí z NS API a mohou obsahovat zpoždění nebo změny nástupiště podle dostupnosti služby.
Dashboard má jasně ukazovat čas, směr a stav zpoždění. Samotný čas bez kontextu může být na větší stanici nejasný.
Řešení potíží
Při autentizační chybě zkontrolujte API klíč a oprávnění v portálu. Při prázdných datech ověřte názvy stanic a dostupnost spojení.
Automatizace s oznámením používejte jen ve dnech, kdy uživatel opravdu cestuje. Změny jízdního řádu po svátcích vyžadují kontrolu tras.
Kontrola po nasazení
Po prvním dni provozu projděte historii entit integrace Nederlandse Spoorwegen (NS). Sledujte, jestli se hodnoty aktualizují podle očekávané komunikace, zda příkazy nemají zpoždění a jestli se v logu neopakují chyby přihlášení, odmítnuté požadavky nebo výpadky dostupnosti.
U zařízení s přímým dopadem na provoz domácnosti nechte správcům jasný postup pro ruční ovládání, vypnutí automatizace a bezpečný návrat do původního stavu. Zapište také místo, kde se spravuje token, heslo, API klíč, adresa zařízení, topic struktura nebo konfigurační soubor.