Edukacja Informacja statystyczna o szkołach i placówkach Zbiór danych zawiera następujące zasoby: Zestawienie ogólne szkoły/placówki ogółem Dzieci i młodzież szkoły/placówki przeznaczone dla dzieci i młodzieży, Młodzież i dorośli - szkoły/placówki przeznaczone dla młodzieży i dorosłych, Dorośli - szkoły/placówki przeznaczone dla dorosłych, Bez kategorii - szkoły/placówki bez kategorii. Zbiór danych został udostępniony przez Biuro Edukacji. Dzieci i młodzież Poprzez API dostępne są dane z tabeli zawierającej następujące kolumny: Typ gimnazjum, liceum ogólnokształcące, liceum profilowane, przedszkole, punkt przedszkolny, szkoła podstawowa, szkoła policealna (ponadgimnazjalna), szkoła specjalna przysposabiająca do pracy dla uczniów z upośledzeniem umysłowym w stopniu umiarkowanym lub znacznym oraz dla uczniów z więcej niż jedną niepełnosprawnością, technikum, technikum uzupełniające dla absolwentów zasadniczych szkół zawodowych, zasadnicza szkoła zawodowa, zespół wychowania przedszkolnego, prowadzonych przez 1
Publ. inne niż JST nauczyciele Liczba nauczycieli w szkołach/placówkach przez osoby Młodzież i dorośli Poprzez API dostępne są dane z tabeli zawierającej następujące kolumny: Typ liceum ogólnokształcące, szkoła policealna (ponadgimnazjalna), technikum, technikum uzupełniające dla absolwentów zasadniczych szkół zawodowych, zasadnicza szkoła zawodowa prowadzonych przez Publ. inne niż JST nauczyciele Liczba nauczycieli w szkołach/placówkach Dorośli przez osoby 2
Poprzez API dostępne są dane z tabeli zawierającej następujące kolumny: Typ gimnazjum, liceum ogólnokształcące, liceum profilowane, przedszkole, punkt przedszkolny, szkoła podstawowa, szkoła policealna (ponadgimnazjalna), szkoła specjalna przysposabiająca do pracy dla uczniów z upośledzeniem umysłowym w stopniu umiarkowanym lub znacznym oraz dla uczniów z więcej niż jedną niepełnosprawnością, technikum, technikum uzupełniające dla absolwentów zasadniczych szkół zawodowych, zasadnicza szkoła zawodowa, zespół wychowania przedszkolnego prowadzonych przez Publ. inne niż JST nauczyciele Liczba nauczycieli w szkołach/placówkach przez osoby Bez kategorii Poprzez API dostępne są dane z tabeli zawierającej następujące kolumny: Typ bursa, centrum kształcenia praktycznego, centrum kształcenia ustawicznego - bez szkół, centrum kształcenia ustawicznego ze szkołami, międzyszkolny ośrodek sportowy, młodzieżowy ośrodek socjoterapii ze szkołami, młodzieżowy ośrodek wychowawczy, młodzieżowy dom kultury, niepubliczna placówka kształcenia ustawicznego i praktycznego, niepubliczna placówka oświatowo-wychowawcza w 3
systemie oświaty, ognisko pracy pozaszkolnej, ogród jordanowski, ogólnokształcąca szkoła muzyczna i stopnia, ośrodek rewalidacyjno-wychowawczy umożliwiający upośledzonym umysłowo realizację obowiązku szkolnego i nauki, ośrodek dokształcania i doskonalenia zawodowego, pałac młodzieży, placówki artystyczne (ognisko artystyczne), poradnia psychologiczno-pedagogiczna, poradnia specjalistyczna, pozaszkolna placówka specjalistyczna, specjalny ośrodek szkolnowychowawczy, specjalny ośrodek wychowawczy, szkolne schronisko młodzieżowe, zespół szkół i placówek oświatowych prowadzonych przez Publ. inne niż JST nauczyciele Liczba nauczycieli w szkołach/placówkach przez osoby Identyfikatory zasobów (resource) Zestawienie ogólne: resource = f9f7ffd8-d268-417e-991a-1553bae5936d Dzieci i młodzież: resource = aac73e9a-c6b3-4b7e-91dd-ebb00a8cdc33 Młodzież i dorośli: resource = 33d79302-9cd9-4aeb-8bbb-d4c8fc0cb8e7 Dorośli: resource = 0e91481e-f690-4cdf-b292-07b52beceb80 Bez kategorii: resource = ad083912-b8c7-44a4-bf7a-cd12ef84cff4 Metoda HTTPS 4
GET Parametry wywołania resource identyfikator zasobu (uwaga wartość id podana w dokumentacji może być przykładowa poprawne id przydzielone do poszczególnych zasobów zawiera portal api.um.warszawa.pl) limit ograniczenie ilości pobieranych danych q (query) wyszukiwanie pełnotekstowe filters użycie filtru w formacie JSON: filters={ typ zmiennej : wartość wyszukiwana } Odpowiedź Struktura odpowiedzi jest następująca { } "results": { properties": [ {"key": "nazwa_kolumny","value": "wartość_rekordu"}, ], } o "limit": "0", o "total": "0" result zwracany objekt JSON properties zwracany wiersz tabeli key nazwa kolumny value wartość rapodru 5
limit limit zwracanej ilości rekordów total ilości rekordów w zasobie URI Dzieci i młodzież: https://api.bihapi.pl/dane/warszawa?resource=aac73e9a-c6b3-4b7e-91dd-ebb00a8cdc33 Przykłady użycia Przykładowe zapytanie (zwraca pierwszych 5 wyników) Przykładowe zapytanie (zwraca wyniki zawierające technikum ) Przykładowe zapytanie z filtrem (zwraca wyniki spełniające warunek dla placówki: typ - bursa. https://api.bihapi.pl/dane/warszawa?resource=aac73e9a-c6b3-4b7e-91ddebb00a8cdc33&limit=5 https://api.bihapi.pl/dane/warszawa?resource=aac73e9a-c6b3-4b7e-91ddebb00a8cdc33&q=technikum https://api.bihapi.pl/dane/warszawa?resource=aac73e9a-c6b3-4b7e-91ddebb00a8cdc33&filters={"typ":"bursa"} Polskie znaki w wywołaniach i odpowiedziach są kodowane w standardzie UTF-8 Uwaga Polskie znaki, np. występujące w nazwach, stanowiących parametry filters i query wymagają kodowania URLencoding (UTF-8) np.: Śródmieście = %C5%9Ar%C3%B3dmie%C5%9Bcie Polskie znaki w wywołaniach i odpowiedziach są kodowane w standardzie UTF-8. 6