API

Szkoły i placówki oświatowe

Organizacja: Urząd Miasta Kielce Endpointy: 9 Nazwa techniczna: school Wersja: v1 Własne Publiczne

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ę.

Tagi

  • Edukacja
  • Instytucje

Wywołania całej usługi API

Wczytywanie statystyk…

Podsumowania dzienne · UTC

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
Licencja Creative Commons Attribution 4.0 International
Organizacja Urząd Miasta Kielce
Poziom otwartości
Kategorie Placówki oświatowe
Tagi Edukacja, Instytucje
Źródła danych Rejestr Szkół i Placówek Oświatowych (RSPO) , Importowane statystyki szkół
Wypróbuj endpoint

Schematy odpowiedzi

Sprawdź udokumentowane schematy odpowiedzi w dokumencie OpenAPI.

Otwórz dokument OpenAPI

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
Request
GET /api/public/school/schools?limit=25&offset=0
Response
[
  {
    "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
Licencja Creative Commons Attribution 4.0 International
Organizacja Urząd Miasta Kielce
Poziom otwartości
Kategorie Placówki oświatowe
Tagi Edukacja, Instytucje
Źródła danych Rejestr Szkół i Placówek Oświatowych (RSPO) , Importowane statystyki szkół
Wypróbuj endpoint

Schematy odpowiedzi

Sprawdź udokumentowane schematy odpowiedzi w dokumencie OpenAPI.

Otwórz dokument OpenAPI

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
Request
GET /api/public/school/schools/12345
Response
{
  "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
Licencja Creative Commons Attribution 4.0 International
Organizacja Urząd Miasta Kielce
Poziom otwartości
Kategorie Placówki oświatowe
Tagi Edukacja, Instytucje
Źródła danych Rejestr Szkół i Placówek Oświatowych (RSPO) , Importowane statystyki szkół
Wypróbuj endpoint

Schematy odpowiedzi

Sprawdź udokumentowane schematy odpowiedzi w dokumencie OpenAPI.

Otwórz dokument OpenAPI

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
Request
GET /api/public/school/school-years?year=2024%2F2025&limit=25&offset=0
Response
[{"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
Licencja Creative Commons Attribution 4.0 International
Organizacja Urząd Miasta Kielce
Poziom otwartości
Kategorie Placówki oświatowe
Tagi Edukacja, Instytucje
Źródła danych Rejestr Szkół i Placówek Oświatowych (RSPO) , Importowane statystyki szkół
Wypróbuj endpoint

Schematy odpowiedzi

Sprawdź udokumentowane schematy odpowiedzi w dokumencie OpenAPI.

Otwórz dokument OpenAPI

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
Request
GET /api/public/school/students?year=2024%2F2025&limit=25&offset=0
Response
[{"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
Licencja Creative Commons Attribution 4.0 International
Organizacja Urząd Miasta Kielce
Poziom otwartości
Kategorie Placówki oświatowe
Tagi Edukacja, Instytucje
Źródła danych Rejestr Szkół i Placówek Oświatowych (RSPO) , Importowane statystyki szkół
Wypróbuj endpoint

Schematy odpowiedzi

Sprawdź udokumentowane schematy odpowiedzi w dokumencie OpenAPI.

Otwórz dokument OpenAPI

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
Request
GET /api/public/school/students/grades?year=2024%2F2025&limit=25&offset=0
Response
[{"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
Licencja Creative Commons Attribution 4.0 International
Organizacja Urząd Miasta Kielce
Poziom otwartości
Kategorie Placówki oświatowe
Tagi Edukacja, Instytucje
Źródła danych Rejestr Szkół i Placówek Oświatowych (RSPO) , Importowane statystyki szkół
Wypróbuj endpoint

Schematy odpowiedzi

Sprawdź udokumentowane schematy odpowiedzi w dokumencie OpenAPI.

Otwórz dokument OpenAPI

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
Request
GET /api/public/school/students/ages?year=2024%2F2025&limit=25&offset=0
Response
[{"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
Licencja Creative Commons Attribution 4.0 International
Organizacja Urząd Miasta Kielce
Poziom otwartości
Kategorie Placówki oświatowe
Tagi Edukacja, Instytucje
Źródła danych Rejestr Szkół i Placówek Oświatowych (RSPO) , Importowane statystyki szkół
Wypróbuj endpoint

Schematy odpowiedzi

Sprawdź udokumentowane schematy odpowiedzi w dokumencie OpenAPI.

Otwórz dokument OpenAPI

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
Request
GET /api/public/school/exams/summaries?year=2024%2F2025&limit=25&offset=0
Response
[{"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
Licencja Creative Commons Attribution 4.0 International
Organizacja Urząd Miasta Kielce
Poziom otwartości
Kategorie Placówki oświatowe
Tagi Edukacja, Instytucje
Źródła danych Rejestr Szkół i Placówek Oświatowych (RSPO) , Importowane statystyki szkół
Wypróbuj endpoint

Schematy odpowiedzi

Sprawdź udokumentowane schematy odpowiedzi w dokumencie OpenAPI.

Otwórz dokument OpenAPI

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
Request
GET /api/public/school/exams/results?year=2024%2F2025&limit=25&offset=0
Response
[{"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
Licencja Creative Commons Attribution 4.0 International
Organizacja Urząd Miasta Kielce
Poziom otwartości
Kategorie Placówki oświatowe
Tagi Edukacja, Instytucje
Źródła danych Rejestr Szkół i Placówek Oświatowych (RSPO) , Importowane statystyki szkół
Wypróbuj endpoint

Schematy odpowiedzi

Sprawdź udokumentowane schematy odpowiedzi w dokumencie OpenAPI.

Otwórz dokument OpenAPI

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. -
Request
GET /api/public/school/school-types?limit=25&offset=0
Response
[{"id":1,"name":"Example institution type"}]