KSH API-beállítások
A Központi Statisztikai Hivatal nyílt adatforrásának elérése: alap URL, API-kulcs, a lekérendő adatkészletek és az érvényességi kör beállítása.
Az API-beállítások képernyőn adja meg, honnan és milyen adatkészleteket töltsön le a rendszer a Központi Statisztikai Hivatal nyílt adatforrásából. A statisztikák importja és a nyers adatkészletek letöltése ezt a beállítást használja.
Beállítás felvétele
- Nyissa meg a KSH → API-beállítások menüt.
- Kattintson a jobb felső kék + gombra (Hozzáadás). Meglévő beállításnál a sor kék, négyzetes ceruza ikonját (Módosítás) használja.
- Az API kód mezőben hagyja meg a „ksh” értéket, az Alap URL mezőben a felajánlott címet.
- Adja meg az API neve mezőt, és ha a szolgáltatás kér ilyet, az API-kulcs mezőt.
- Ha a beállítás csak egy cégcsoportra vagy cégre érvényes, válassza ki az Ügyfél CÉGCSOPORT és a Partnerazonosító mezőt; üresen hagyva a beállítás mindenkire érvényes.
- A Lekérendő adatkészletek listában jelölje be azokat az adatkészleteket, amelyeket a rendszer letöltsön.
- Kattintson a Kapcsolat próbája gombra. Sikeres próbánál ilyen üzenet jelenik meg: „A kapcsolat rendben - 120 adatkészlet érkezett.”
- Kattintson a jobb felső Mentés gombra. Az üzenet: „Siker: az API-konfiguráció mentve.”
Mezők
| Mező | Mit írjon bele | Kötelező |
|---|---|---|
| API kód | A forrás kódja; a statisztikai funkciók a „ksh” kódú beállítást keresik. | igen |
| API neve | Megnevezés a listában. | nem |
| Alap URL | A forrás címe, alapból a hivatal nyílt adatportálja. | nem |
| Konfiguráció (JSON) | Haladó beállítás, például a statisztikai mutatók listája. Csak érvényes szerkezet menthető. | nem |
| Státusz | Aktív vagy Inaktív; csak aktív beállítást használ a rendszer. | nem |
Műveletek a listában
A sor zöld pipa ikonja aktiválja, a sárga tiltó ikonja inaktiválja a beállítást, a piros kuka ikon törli. Ha több beállítás is van, a rendszer előbb a cégre, majd a cégcsoportra szóló, végül a mindenkire érvényes aktív beállítást használja.
Példa
A Minta Kft. csak a megyei medián életkort szeretné látni. Felvesz egy „ksh” kódú beállítást, a kapcsolat próbája rendben van, majd a KSH-statisztikák importjával letölti az adatot.