API
Szkoły i placówki oświatowe
Szkoły i placówki oświatowe w Kielcach ujęte w Rejestrze Szkół i Placówek Oświatowych (RSPO). Wykaz obejmuje placówki publiczne i niepubliczne, m.in. przedszkola, szkoły podstawowe i ponadpodstawowe, poradnie oraz zespoły szkół. Dla każdej pozycji podano numer RSPO, nazwę, rodzaj i adres, a mapa pokazuje jej lokalizację.
Wywołania całej usługi API
Wczytywanie statystyk…
Podsumowania dzienne · UTC
| Czas (UTC) | Seria | Wartość |
|---|
Dokumentacja
Katalog RSPO uzupełniają dostępne importowane statystyki szkół. Listy mają limit 100 rekordów i obsługują dokładny filtr roku szkolnego. Listy statystyk obsługują także schoolId. Brak wiersza oznacza brak danych, a nie zero; puste wartości źródłowe pozostają null. Grade oznacza poziom klasy, a nie liczbę oddziałów. Przedziały lat urodzenia zachowują grupowanie źródła, w tym otwartą dolną granicę. Średnie wyniki egzaminów są tekstowymi liczbami dziesiętnymi. Dane nie obejmują identyfikatorów podatkowych instytucji, danych kontaktowych ani rekordów poszczególnych osób.
Endpointy API
GET
/schools
Szkoły
json
Lista zsynchronizowanych szkół, opcjonalnie ograniczona do dokładnego institutionTypeId odczytanego ze słownika.
Metadane publikacyjne danych
Wypróbuj endpoint
Schematy odpowiedzi
Endpoint
/api/public/school/schools?version=v1
Parametry
| Nazwa | Położenie | Typ | Wymaganie | Opis | przykład |
|---|---|---|---|---|---|
limit |
query | integer |
opcjonalny | Maksymalna liczba zwracanych rekordów (nie więcej niż 100). | 25 |
offset |
query | integer |
opcjonalny | Liczba pomijanych rekordów. | - |
institutionTypeId |
query | integer |
opcjonalny | Dokładny identyfikator typu placówki odczytany przez /school-types; typy przedszkoli lub punktów wybierz z zapisanego słownika. | 1 |
GET /api/public/school/schools?limit=25&offset=0
[
{
"uri": "https://data.example.test/api/public/school/schools/12345",
"id": 12345,
"name": "Public Primary School",
"type": "Primary school",
"addressStreet": "Krakowska",
"addressNumber": "10",
"location": {"lat": 50.8501, "lon": 20.6154}
}
]
GET
/schools/{schoolId}
Szkoła
json
Zwraca jedną szkołę po stabilnym identyfikatorze RSPO.
Metadane publikacyjne danych
Wypróbuj endpoint
Schematy odpowiedzi
Endpoint
/api/public/school/schools/{schoolId}?version=v1
Parametry
| Nazwa | Położenie | Typ | Wymaganie | Opis | przykład |
|---|---|---|---|---|---|
schoolId |
ścieżka | integer |
wymagany | Stabilny identyfikator szkoły RSPO. | 12345 |
GET /api/public/school/schools/12345
{
"uri": "https://data.example.test/api/public/school/schools/12345",
"id": 12345,
"name": "Public Primary School",
"type": "Primary school",
"addressStreet": "Krakowska",
"addressNumber": "10",
"location": {"lat": 50.8501, "lon": 20.6154}
}
GET
/school-years
Lata szkolne
json
Lista skonfigurowanych lat szkolnych i ich granic kalendarzowych, od najnowszego.
Metadane publikacyjne danych
Wypróbuj endpoint
Schematy odpowiedzi
Endpoint
/api/public/school/school-years?version=v1
Parametry
| Nazwa | Położenie | Typ | Wymaganie | Opis | przykład |
|---|---|---|---|---|---|
limit |
query | integer |
opcjonalny | Maksymalna liczba zwracanych rekordów (nie więcej niż 100). | 25 |
offset |
query | integer |
opcjonalny | Liczba pomijanych rekordów. | - |
year |
query | string |
opcjonalny | Dokładny identyfikator roku szkolnego z kolejnymi latami, na przykład 2024/2025. | 2024/2025 |
GET /api/public/school/school-years?year=2024%2F2025&limit=25&offset=0
[{"id":"2024/2025","fromDate":"2024-09-01","toDate":"2025-08-31"}]
GET
/students
Roczne liczby uczniów
json
Dostępne liczby uczniów i absolwentów według szkoły i roku.
Metadane publikacyjne danych
Wypróbuj endpoint
Schematy odpowiedzi
Endpoint
/api/public/school/students?version=v1
Parametry
| Nazwa | Położenie | Typ | Wymaganie | Opis | przykład |
|---|---|---|---|---|---|
limit |
query | integer |
opcjonalny | Maksymalna liczba zwracanych rekordów (nie więcej niż 100). | 25 |
offset |
query | integer |
opcjonalny | Liczba pomijanych rekordów. | - |
year |
query | string |
opcjonalny | Dokładny identyfikator roku szkolnego z kolejnymi latami, na przykład 2024/2025. | 2024/2025 |
schoolId |
query | integer |
opcjonalny | Stabilny identyfikator szkoły RSPO. | 12345 |
GET /api/public/school/students?year=2024%2F2025&limit=25&offset=0
[{"schoolId":12345,"year":"2024/2025","studentsQuantity":120,"graduatesQuantity":18}]
GET
/students/grades
Uczniowie według poziomu klasy i płci
json
Liczby uczniów według poziomu klasy i płci; nie są to liczby oddziałów.
Metadane publikacyjne danych
Wypróbuj endpoint
Schematy odpowiedzi
Endpoint
/api/public/school/students/grades?version=v1
Parametry
| Nazwa | Położenie | Typ | Wymaganie | Opis | przykład |
|---|---|---|---|---|---|
limit |
query | integer |
opcjonalny | Maksymalna liczba zwracanych rekordów (nie więcej niż 100). | 25 |
offset |
query | integer |
opcjonalny | Liczba pomijanych rekordów. | - |
year |
query | string |
opcjonalny | Dokładny identyfikator roku szkolnego z kolejnymi latami, na przykład 2024/2025. | 2024/2025 |
schoolId |
query | integer |
opcjonalny | Stabilny identyfikator szkoły RSPO. | 12345 |
GET /api/public/school/students/grades?year=2024%2F2025&limit=25&offset=0
[{"schoolId":12345,"year":"2024/2025","grade":4,"quantityFemales":10,"quantityMales":12}]
GET
/students/ages
Uczniowie według roku urodzenia
json
Liczby uczniów według domkniętego przedziału lat urodzenia; null oznacza otwartą dolną granicę.
Metadane publikacyjne danych
Wypróbuj endpoint
Schematy odpowiedzi
Endpoint
/api/public/school/students/ages?version=v1
Parametry
| Nazwa | Położenie | Typ | Wymaganie | Opis | przykład |
|---|---|---|---|---|---|
limit |
query | integer |
opcjonalny | Maksymalna liczba zwracanych rekordów (nie więcej niż 100). | 25 |
offset |
query | integer |
opcjonalny | Liczba pomijanych rekordów. | - |
year |
query | string |
opcjonalny | Dokładny identyfikator roku szkolnego z kolejnymi latami, na przykład 2024/2025. | 2024/2025 |
schoolId |
query | integer |
opcjonalny | Stabilny identyfikator szkoły RSPO. | 12345 |
GET /api/public/school/students/ages?year=2024%2F2025&limit=25&offset=0
[{"schoolId":12345,"year":"2024/2025","birthYearFrom":null,"birthYearTo":2015,"quantity":22}]
GET
/exams/summaries
Podsumowania egzaminów
json
Typ egzaminu oraz liczby zdających i świadectw według szkoły i roku; niedostępne liczby pozostają null.
Metadane publikacyjne danych
Wypróbuj endpoint
Schematy odpowiedzi
Endpoint
/api/public/school/exams/summaries?version=v1
Parametry
| Nazwa | Położenie | Typ | Wymaganie | Opis | przykład |
|---|---|---|---|---|---|
limit |
query | integer |
opcjonalny | Maksymalna liczba zwracanych rekordów (nie więcej niż 100). | 25 |
offset |
query | integer |
opcjonalny | Liczba pomijanych rekordów. | - |
year |
query | string |
opcjonalny | Dokładny identyfikator roku szkolnego z kolejnymi latami, na przykład 2024/2025. | 2024/2025 |
schoolId |
query | integer |
opcjonalny | Stabilny identyfikator szkoły RSPO. | 12345 |
GET /api/public/school/exams/summaries?year=2024%2F2025&limit=25&offset=0
[{"schoolId":12345,"year":"2024/2025","examType":"e8","participantsTotal":18,"certificatesTotal":null}]
GET
/exams/results
Wyniki egzaminów z przedmiotów
json
Wyniki egzaminów z identyfikatorem i nazwą przedmiotu, poziomem i opcjonalnym zakresem; niedostępna liczba zdających i średnia pozostają null.
Metadane publikacyjne danych
Wypróbuj endpoint
Schematy odpowiedzi
Endpoint
/api/public/school/exams/results?version=v1
Parametry
| Nazwa | Położenie | Typ | Wymaganie | Opis | przykład |
|---|---|---|---|---|---|
limit |
query | integer |
opcjonalny | Maksymalna liczba zwracanych rekordów (nie więcej niż 100). | 25 |
offset |
query | integer |
opcjonalny | Liczba pomijanych rekordów. | - |
year |
query | string |
opcjonalny | Dokładny identyfikator roku szkolnego z kolejnymi latami, na przykład 2024/2025. | 2024/2025 |
schoolId |
query | integer |
opcjonalny | Stabilny identyfikator szkoły RSPO. | 12345 |
GET /api/public/school/exams/results?year=2024%2F2025&limit=25&offset=0
[{"schoolId":12345,"year":"2024/2025","examType":"e8","subjectId":"00000000-0000-4000-8000-000000000001","subjectName":"Mathematics","level":"basic","scope":null,"participants":18,"average":"71.25"}]
GET
/school-types
Typy placówek oświatowych
json
Zsynchronizowane identyfikatory i nazwy typów placówek do wyboru części katalogu, w tym przedszkoli i punktów przedszkolnych.
Metadane publikacyjne danych
Wypróbuj endpoint
Schematy odpowiedzi
Endpoint
/api/public/school/school-types?version=v1
Parametry
| Nazwa | Położenie | Typ | Wymaganie | Opis | przykład |
|---|---|---|---|---|---|
limit |
query | integer |
opcjonalny | Maksymalna liczba zwracanych rekordów (nie więcej niż 100). | 25 |
offset |
query | integer |
opcjonalny | Liczba pomijanych rekordów. | - |
GET /api/public/school/school-types?limit=25&offset=0
[{"id":1,"name":"Example institution type"}]