TapHome

CNB CZK Exchange Rates

Packet Parser → HTTP
Autor
Posljednje ažuriranje: 10. 2026
CNB CZK Exchange Rates

Češka narodna banka (ČNB) svakodnevno objavljuje službene tečajeve češke krune (CZK) za 30 stranih valuta. To su službeni tečajevi fixinga koji služe kao referenca u cijelom češkom financijskom sustavu.

Predložak TapHome preuzima svih 30 tečajeva iz javnog REST API-ja ČNB-a (api.cnb.cz) preko HTTP Packet Parsera. Svaka valuta prikazuje se kao zaseban senzor samo za čitanje s trenutačnim tečajem u CZK. API je potpuno javan: nisu potrebni autentifikacija, API ključ ni registracija. TapHome preuzima tečajeve jednom na sat; ČNB objavljuje nove tečajeve jednom svakog radnog dana oko 14:30.

Konfiguracija

Predložak se spaja na api.cnb.cz preko HTTPS-a (port 443). Nisu potrebni IP adresa, pristupni podaci ni API ključ, jer je krajnja točka potpuno javni državni API.

Nema varijabli koje korisnik postavlja. Jedina prilagođena varijabla (responsejson) interna je predmemorija HTTP odgovora koju koriste skripte predloška i ne treba je mijenjati.

Kako radi

Modul šalje jedan HTTP GET zahtjev jednom na sat (interval očitavanja 3 600 000 ms):

1

GET /cnbapi/exrates/daily?date={today}&lang=CZ

Odgovor je JSON objekt s poljem rates[] koje sadrži svih 30 valuta. Svaka stavka sadrži oznaku valute, naziv države, količinu i tečaj. Modul cijeli JSON odgovor sprema u varijablu responsejson.

Svaki senzor valute zatim čita svoj tečaj iz spremljenog odgovora pomoću PARSEJSON(responsejson, "$.rates[N].rate"), gdje je N fiksni indeks valute u polju. Interval očitavanja uređaja je 15 sekundi, ali budući da svi uređaji čitaju iz spremljene varijable responsejson, između dvaju uzastopnih satnih osvježavanja ne šalju se dodatni API pozivi.

Predložak u API zahtjevu koristi lang=CZ. To je ključno, jer je polje rates[] abecedno poredano prema nazivu države na odabranom jeziku. Promjena na lang=EN dala bi drugačiji redoslijed i pokvarila sva preslikavanja indeksa polja.

Mogućnosti uređaja

Predložak daje 30 senzora samo za čitanje, po jedan za svaku valutu. Sve vrijednosti su u CZK.

Glavne valute

Najčešće praćeni tečajevi su EUR (euro), USD (američki dolar), GBP (britanska funta), CHF (švicarski franak) i PLN (poljski zlot). Iskazuju se za 1 jedinicu strane valute, na primjer tečaj USD od 21,315 znači 1 USD = 21,315 CZK.

Valute s tečajem za više jedinica

Devet valuta zbog niske vrijednosti jedne jedinice u CZK ima tečaj za više jedinica:

ValutaKoličinaZnačenje
HUF (mađarska forinta)100Tečaj za 100 HUF
INR (indijska rupija)100Tečaj za 100 INR
ISK (islandska kruna)100Tečaj za 100 ISK
JPY (japanski jen)100Tečaj za 100 JPY
KRW (južnokorejski von)100Tečaj za 100 KRW
PHP (filipinski pezo)100Tečaj za 100 PHP
THB (tajlandski baht)100Tečaj za 100 THB
TRY (turska lira)100Tečaj za 100 TRY
IDR (indonezijska rupija)1000Tečaj za 1000 IDR

Predložak čita izvornu vrijednost rate iz API-ja bez dijeljenja s amount. Na primjer, tečaj JPY od 13,328 u sustavu TapHome znači 100 JPY = 13,328 CZK, a ne 1 JPY = 13,328 CZK.

Potpuni popis valuta

Svih 30 valuta: AUD, BRL, CAD, CHF, CNY, DKK, EUR, GBP, HKD, HUF, IDR, ILS, INR, ISK, JPY, KRW, MXN, MYR, NOK, NZD, PHP, PLN, RON, SEK, SGD, THB, TRY, USD, XDR (posebna prava vučenja MMF-a), ZAR.

Primjeri automatizacije

Obavijest pri pragu tečaja

Senzor valute upotrijebite u uvjetu smart rule kako biste primili obavijest kada tečaj prijeđe prag:

  • Uvjet: vrijednost EUR prijeđe iznad 25,00
  • Radnja: slanje push obavijesti
Upravljanje prema tečaju

Pokrenite radnje prema kretanju tečaja, na primjer promijenite stanje pokazivača na zaslonu ili upravljajte izlazima kada praćena valuta dosegne ciljni raspon.

Rješavanje problema

Svi uređaji prikazuju nulu ili nemaju podataka
  1. Provjerite internetsku vezu centralne jedinice TapHome Core: predložak treba izlazni HTTPS pristup prema api.cnb.cz
  2. Provjerite odgovara li API: u pregledniku otvorite https://api.cnb.cz/cnbapi/exrates/daily?date=2026-03-28&lang=CZ
  3. Novi tečajevi objavljuju se svaki radni dan oko 14:30 CET. Vikendom i praznicima API vraća posljednje važeće tečajeve
Vrijednosti nekih valuta izgledaju netočno

Pogledajte gornju tablicu valuta s tečajem za više jedinica. Valute poput JPY, HUF, KRW i IDR iskazuju se za 100 ili 1000 jedinica, a ne za 1 jedinicu. To je uobičajena konvencija ČNB-a, a ne pogreška predloška.

Podaci se prestanu ažurirati

Predložak očitava API jednom na sat. Ako tečajevi izgledaju zastarjelo, provjerite ima li TapHome Core pristup internetu i je li API ČNB-a dostupan. API nema dokumentirana ograničenja broja zahtjeva, ali duži prekidi veze spriječit će ažuriranje.

Dostupni uređaji

CNB CZK tečajevi Modul
Prilagođene varijable

Kurzy ČNB

Čitanje (modul)
VAR today := tostring(NOW(), "yyyy-MM-dd");
VAR response := SENDHTTPREQUEST("/cnbapi/exrates/daily?date=" + today + "&lang=CZ");
IF response.IsSuccess
    responsejson := response.Content;
ELSE
    ADDERROR(response.StatusCode + " (" + response.ReasonPhrase + ")");
END
Australski dolar (AUD) Varijabla Samo za čitanje
string Jedinica: CZK json_path

Australski dolar (AUD)

Čitanje
PARSEJSON(responsejson, "$.rates[0].rate");
Brazilski real (BRL) Varijabla Samo za čitanje
string Jedinica: CZK json_path

Brazilski real (BRL)

Čitanje
PARSEJSON(responsejson, "$.rates[1].rate");
Kanadski dolar (CAD) Varijabla Samo za čitanje
string Jedinica: CZK json_path

Kanadski dolar (CAD)

Čitanje
PARSEJSON(responsejson, "$.rates[13].rate");
Kineski renminbi (CNY) Varijabla Samo za čitanje
string Jedinica: CZK json_path

Kineski renminbi (CNY)

Čitanje
PARSEJSON(responsejson, "$.rates[2].rate");
Danska kruna (DKK) Varijabla Samo za čitanje
string Jedinica: CZK json_path

Danska kruna (DKK)

Čitanje
PARSEJSON(responsejson, "$.rates[3].rate");
Euro (EUR) Varijabla Samo za čitanje
string Jedinica: CZK json_path

Euro (EUR)

Čitanje
PARSEJSON(responsejson, "$.rates[4].rate");
Britanska funta (GBP) Varijabla Samo za čitanje
string Jedinica: CZK json_path

Britanska funta (GBP)

Čitanje
PARSEJSON(responsejson, "$.rates[29].rate");
Hongkonški dolar (HKD) Varijabla Samo za čitanje
string Jedinica: CZK json_path

Hongkonški dolar (HKD)

Čitanje
PARSEJSON(responsejson, "$.rates[6].rate");
Mađarska forinta (HUF) Varijabla Samo za čitanje

Tečaj za 100 HUF

string Jedinica: CZK json_path

Mađarska forinta (HUF)

Čitanje
PARSEJSON(responsejson, "$.rates[15].rate");
Švicarski franak (CHF) Varijabla Samo za čitanje
string Jedinica: CZK json_path

Švicarski franak (CHF)

Čitanje
PARSEJSON(responsejson, "$.rates[25].rate");
Indonezijska rupija (IDR) Varijabla Samo za čitanje

Tečaj za 1000 IDR

string Jedinica: CZK json_path

Indonezijska rupija (IDR)

Čitanje
PARSEJSON(responsejson, "$.rates[8].rate");
Izraelski šekel (ILS) Varijabla Samo za čitanje
string Jedinica: CZK json_path

Izraelski šekel (ILS)

Čitanje
PARSEJSON(responsejson, "$.rates[10].rate");
Indijska rupija (INR) Varijabla Samo za čitanje

Tečaj za 100 INR

string Jedinica: CZK json_path

Indijska rupija (INR)

Čitanje
PARSEJSON(responsejson, "$.rates[7].rate");
Islandska kruna (ISK) Varijabla Samo za čitanje

Tečaj za 100 ISK

string Jedinica: CZK json_path

Islandska kruna (ISK)

Čitanje
PARSEJSON(responsejson, "$.rates[9].rate");
Japanski jen (JPY) Varijabla Samo za čitanje

Tečaj za 100 JPY

string Jedinica: CZK json_path

Japanski jen (JPY)

Čitanje
PARSEJSON(responsejson, "$.rates[11].rate");
Južnokorejski von (KRW) Varijabla Samo za čitanje

Tečaj za 100 KRW

string Jedinica: CZK json_path

Južnokorejski von (KRW)

Čitanje
PARSEJSON(responsejson, "$.rates[14].rate");
Meksički pezo (MXN) Varijabla Samo za čitanje
string Jedinica: CZK json_path

Meksički pezo (MXN)

Čitanje
PARSEJSON(responsejson, "$.rates[17].rate");
Malezijski ringit (MYR) Varijabla Samo za čitanje
string Jedinica: CZK json_path

Malezijski ringit (MYR)

Čitanje
PARSEJSON(responsejson, "$.rates[16].rate");
Norveška kruna (NOK) Varijabla Samo za čitanje
string Jedinica: CZK json_path

Norveška kruna (NOK)

Čitanje
PARSEJSON(responsejson, "$.rates[19].rate");
Novozelandski dolar (NZD) Varijabla Samo za čitanje
string Jedinica: CZK json_path

Novozelandski dolar (NZD)

Čitanje
PARSEJSON(responsejson, "$.rates[20].rate");
Filipinski pezo (PHP) Varijabla Samo za čitanje

Tečaj za 100 PHP

string Jedinica: CZK json_path

Filipinski pezo (PHP)

Čitanje
PARSEJSON(responsejson, "$.rates[5].rate");
Poljski zlot (PLN) Varijabla Samo za čitanje
string Jedinica: CZK json_path

Poljski zlot (PLN)

Čitanje
PARSEJSON(responsejson, "$.rates[21].rate");
Rumunjski lej (RON) Varijabla Samo za čitanje
string Jedinica: CZK json_path

Rumunjski lej (RON)

Čitanje
PARSEJSON(responsejson, "$.rates[22].rate");
Švedska kruna (SEK) Varijabla Samo za čitanje
string Jedinica: CZK json_path

Švedska kruna (SEK)

Čitanje
PARSEJSON(responsejson, "$.rates[24].rate");
Singapurski dolar (SGD) Varijabla Samo za čitanje
string Jedinica: CZK json_path

Singapurski dolar (SGD)

Čitanje
PARSEJSON(responsejson, "$.rates[23].rate");
Tajlandski baht (THB) Varijabla Samo za čitanje

Tečaj za 100 THB

string Jedinica: CZK json_path

Tajlandski baht (THB)

Čitanje
PARSEJSON(responsejson, "$.rates[26].rate");
Turska lira (TRY) Varijabla Samo za čitanje

Tečaj za 100 TRY

string Jedinica: CZK json_path

Turska lira (TRY)

Čitanje
PARSEJSON(responsejson, "$.rates[27].rate");
Američki dolar (USD) Varijabla Samo za čitanje
string Jedinica: CZK json_path

Američki dolar (USD)

Čitanje
PARSEJSON(responsejson, "$.rates[28].rate");
MMF SDR (XDR) Varijabla Samo za čitanje

Posebna prava vučenja MMF-a (SDR), složena pričuvna imovina

string Jedinica: CZK json_path

MMF SDR (XDR)

Čitanje
PARSEJSON(responsejson, "$.rates[18].rate");
Južnoafrički rand (ZAR) Varijabla Samo za čitanje
string Jedinica: CZK json_path

Južnoafrički rand (ZAR)

Čitanje
PARSEJSON(responsejson, "$.rates[12].rate");
Povezivanje: Packet Parser → HTTP

Izvori

  • CNB API — OpenAPI Specification
    api.cnb.cz 2026-03-28
  • CNB Exchange Rate Format & Currency List
    www.cnb.cz 2026-03-28

Pronašli ste problem s ovim predloškom uređaja?

Recite nam što ne radi, što nedostaje ili kako bi se predložak trebao ponašati. Vaše povratne informacije pomažu nam da katalog bude točan.

Provjerio TapHome

Želite ovo koristiti u svojoj centralnoj jedinici TapHome Core?

Otvorite ovaj predložak na portalu Customer Portal kako biste ga primijenili na jedan od svojih domova ili predložili poboljšanje i poslali ga natrag u katalog.

Otvorite na portalu