O tym API
Dane w PxStat są zorganizowane w wielowymiarowe kostki (cubes), z których każda ma unikatowy kod macierzy (np. EP001 — wstępne zmiany liczby ludności 2011–2016). Metoda ReadDataset zwraca wskazaną kostkę pod adresem ws.cso.ie/public/api.restful/PxStat.Data.Cube_API.ReadDataset/{macierz}/{format}/{wersja}/{język}. Oprócz JSON-stat 2.0 dostępne są formaty PX, CSV i XLSX, a treść w językach angielskim i irlandzkim. Odpowiedzi JSON-stat 2.0 zawierają pełne metadane wymiarów (kategorie, etykiety, jednostki), więc agent może zinterpretować dane bez osobnego słownika kodów. Dostęp jest anonimowy (nagłówek www-authenticate: Anonymous), a serwer odsyła nagłówek CORS odbijający Origin zapytania, co pozwala wołać API także z kodu przeglądarki. Dane są objęte licencją Creative Commons Attribution 4.0 (CC BY 4.0) — wolno je używać, również komercyjnie, pod warunkiem wskazania źródła (CSO).
Najczęstsze pytania
Czy trzeba mieć klucz API?
Nie. API PxStat jest w pełni anonimowe — nie wymaga klucza ani rejestracji. Zapytania wykonuje się zwykłym żądaniem GET, a serwer zwraca nagłówek uwierzytelniania Anonymous.
Jakie dane zwraca to API?
Oficjalne statystyki Irlandii z bazy PxStat: spisy ludności i dane demograficzne, gospodarkę, rynek pracy, ceny, handel i wiele innych dziedzin. Każdy zbiór to wielowymiarowa kostka wskazywana kodem macierzy (np. EP001) i zwracana w formacie JSON-stat 2.0 (dostępne też PX, CSV, XLSX) po angielsku lub irlandzku.
Czy można wywołać to API bezpośrednio z przeglądarki?
Tak. Serwer odsyła nagłówek CORS odbijający Origin zapytania (access-control-allow-origin), więc API działa bezpośrednio z kodu front-endowego JavaScript — dlatego obok znajduje się działający przycisk „Wypróbuj”.
Kto prowadzi to API?
Centralny Urząd Statystyczny (Central Statistics Office, CSO) — krajowy urząd statystyczny Irlandii. API jest częścią jego otwartej platformy danych PxStat (data.cso.ie).