Wprowadzenie
API przeszukiwania danych zawiera serwisy, które pozwalają na pobieranie danych wg zadanych kryteriów. Systemy klienckie mogą wykorzystać tę funkcjonalność do budowania modułów opartych o bazę danych SAOS, bez potrzeby pobierania i składowania danych we własnej bazie.
Jeśli jesteś raczej zainteresowany pobraniem wszystkich danych do swojej bazy skorzystaj z API pobierania danych.
Punkt wejścia
Adres
https://www.saos.org.pl/api/search
Opis
Publikuje listę serwisów (obecnie jeden) przeszukiwania danych:
- wyszukiwarka orzeczeń
Serwis wyszukiwarki orzeczeń
Adres
https://www.saos.org.pl/api/search/judgments
Opis
Umożliwia przeszukiwanie bazy orzeczeń wg zadanych parametrów. Pozwala napisać skrypt lub aplikację kliencką korzystającą z bazy orzeczeń SAOS.
Uwaga: ten serwis nie służy do pobierania bazy orzeczeń (niepełne dane, brak łatwej synchronizacji). W celu pobrania/aktualizacji bazy orzeczeń należy skorzystać z API pobierania danych.
Parametry
| nazwa | typ | wartość domyślna | wartości dozwolone | opis |
|---|---|---|---|---|
| pageSize | Liczba całkowita | 20 | >=10 i =<100 | Maksymalna liczba elementów na stronie (pobieranych przez jedno żądanie) |
| pageNumber | Liczba całkowita | 0 | >=0 | Numer żądanej strony |
| sortingField | Słownik | DATABASE_ID |
|
Pole wg którego dane będą posortowane. Istnieje możliwość sortowania tylko po jednym polu jednocześnie. |
| sortingDirection | Słownik | ASC | ASC lub DESC | Kierunek sortowania danych. ASC - w górę, DESC - w dół. |
| all | Tekst | pusta [wszystkie] | Tekst szukanej frazy zgodny z językiem zapytań | Fraza poszukiwana we wszystkich polach orzeczenia (metadane i treść). Tylko orzeczenia, które w jakimkolwiek polu zawierają frazę przypisaną do tego parametru, znajdą się w wynikach wyszukiwania. |
| legalBase | Tekst | pusta [dowolna] | Tekst szukanej frazy zgodny z językiem zapytań | Podstawa prawna. Podstawy prawne przypisane do orzeczeń w systemach źródłowych NIE są przechowywane w ustandaryzowanym (zesłownikowanym) formacie, lecz jako zwykły tekst (np. 'art. 23 k.c. oraz art. 103 uksc.' lub 'art.32, 34 ustawy o zawodzie lekarza i lekarza dentysty'). To powoduje, że jest możliwe jedynie tekstowe przeszukiwanie po tym polu. |
| referencedRegulation | Tekst | pusta [dowolny] | Tekst szukanej frazy zgodny z językiem zapytań | Powołany przepis. Podana fraza będzie szukana w tekście przepisu znajdującego się w metadanych orzeczenia. |
| lawJournalEntryCode | Tekst | pusta [dowolny] | Numer dziennika ustaw w formacie: rok/nr pozycji | Pozycja dziennika ustaw przywołana w powołanym przepisie. |
| judgeName | Tekst | pusta [dowolny] | Tekst szukanej frazy zgodny z językiem zapytań | Imię i nazwisko sędziego. |
| caseNumber | Tekst | pusta [dowolny] | Dowolny tekst | Sygnatura akt sprawy. Podana sygnatura musi być dokładnie taka, jakiej szukamy, wyszukiwarka szuka po pełnej sygnaturze - nie po jej części. |
| courtType | Słownik | pusta [dowolny] |
APPEAL // apelacyjny REGIONAL // okręgowy DISTRICT // rejonowy |
Typ sądu powszechnego. |
| ccCourtId | Liczba całkowita | pusta [dowolny] | Dowolna liczba całkowita // odpowiednik typu long w javie | Identyfikator wewnętrzny sądu powszechnego w SAOS. |
| ccCourtCode | Tekst | pusta [dowolny] | Dowolny tekst | Kod sądu powszechnego otrzymywany z systemu źródłowego. Postać to ciąg cyfr, np. dla sądu apelacyjnego we Wrocławiu: 15500000 |
| ccCourtName | Tekst | pusta [dowolna] | Dowolny tekst | Pełna (dokładna) nazwa sądu powszechnego, np. Sąd Apelacyjny we Wrocławiu [ważna wielkość liter] |
| ccDivisionId | Liczba całkowita | pusta [dowolny] | Dowolna liczba całkowita // odpowiednik typu long w javie | Identyfikator wewnętrzny wydziału sądu powszechnego w SAOS [unikalny w ramach wszystkich wydziałów wszystkich sądów] |
| ccDivisionCode | Tekst | pusta [dowolny] | Dowolny tekst | Kod wydziału sądu powszechnego otrzymywany z systemu źródłowego i unikalny w ramach jednego sądu. Postać to ciąg cyfr, np. 0001506 (Wydział Karny). |
| ccDivisionName | Tekst | pusta [dowolny] | Dowolny tekst | Pełna (dokładna) nazwa wydziału, np. II Wydział Cywilny Odwoławczy [ważna wielkość liter]. |
| ccIncludeDependentCourtJudgments | Boolean | false | true/ false |
Czy uwzględnić orzeczenia sądów podrzędnych dla określonego sądu powszechnego? Flaga ma sens w przypadku określenia sądu powszechnego przez ccCourtId. Przykład: ccCourtId = identyfikator sądu Apelacyjnego w Białymstoku. Jeśli ccIncludeDependentCourtJudgments ustawiona na false, wtedy będą brane pod uwagę jedynie orzeczenia wydane przez Sąd Apelacyjny w Białymstoku. W przypadku wartości true pokazane będą również orzeczenia z wszystkich sądów okręgowych i rejonowych z apelacji białostockiej. |
| scPersonnelType | Słownik | pusta [dowolny] |
ONE_PERSON // skład jednoosobowy THREE_PERSON // trzyosobowy FIVE_PERSON // pięcioosobowy SEVEN_PERSON // siedmioosobowy ALL_COURT // skład całego Sądu Najwyższego ALL_CHAMBER // skład pełnej izby JOINED_CHAMBERS // skład połączonych izb |
Typ orzekającego składu sędziowskiego Sądu Najwyższego. |
| scJudgmentForm | Tekst | pusta [dowolny] |
Dowolny tekst |
Forma orzeczenia Sądu Najwyższego, np. wyrok SN. Fraza musi być pełna i dokładna z uwzględnieniem wielkości liter. |
| scChamberId | Liczba całkowita | pusta [dowolny] |
Dowolna liczba całkowita // odpowiednik typu long w javie |
Identyfikator wewnętrzny izby Sądu Najwyższego w SAOS. |
| scChamberName | Tekst | pusta [dowolna] |
Dowolny tekst. |
Nazwa izby sądu najwyższego. Pełna i dokładna nazwa z uwzględnieniem wielkości liter. |
| scDivisionId | Liczba całkowita | pusta [dowolny] |
Dowolna liczba całkowita // odpowiednik typu long w javie |
Identyfikator wewnętrzny wydziału izby SN w SAOS, unikalny w ramach wszystkich wydziałów wszystkich izb. |
| scDivisionName | Tekst | pusta [dowolna] |
Dowolny tekst. |
Nazwa wydziału izby sądu najwyższego. Pełna i dokładna nazwa z uwzględnieniem wielkości liter. |
| judgmentTypes | Słownik | pusta [dowolny] |
DECISION // postanowienie RESOLUTION // uchwała SENTENCE // wyrok REGULATION // zarządzenie REASONS // uzasadnienie; źródło orzeczeń sądów powszechnych udostępnia niektóre orzeczenia jako dwa odrębne: wyrok i uzasadnienie |
Typ orzeczenia. Można podać więcej niż jeden interesujący typ orzeczenia, np. judgmentTypes=RESOLUTION&judgmentTypes=DECISION. W przypadku podania więcej niż jednego typu będą pokazane wszystkie orzeczenia, które mają jeden z podanych typów [wyszukiwanie na zasadzie LUB]. |
| keywords | Tekst | pusta [dowolny] | Dowolny tekst. | Słowa kluczowe [są określone tylko dla orzeczeń sądów powszechnych]. Dokładny tekst słowa kluczowego (hasła tematycznego). Można podać więcej niż jedno słowo kluczowe, wtedy będą wyszukiwane orzeczenia zawierające wszystkie podane słowa kluczowe [wyszukiwanie na zasadzie ORAZ], np. keywords=emerytura&keywords=swobodna ocena dowodów. |
| judgmentDateFrom | Data | pusta [dowolna] | Tekst w formacie: yyyy-MM-dd | Dolne ograniczenie daty orzeczenia. |
| judgmentDateTo | Data | pusta [dowolna] | Tekst w formacie: yyyy-MM-dd | Górne ograniczenie daty orzeczenia. |
Odpowiedź
Obiekt items
| ścieżka | typ | możliwe wartości | opis |
|---|---|---|---|
| id | Liczba całkowita | >0 | Identyfikator orzeczenia w systemie SAOS |
| href | Url | Url API z pełnymi danymi orzeczenia. Zobacz: API przeglądania danych | |
| courtType | Słownik |
COMMON // sąd powszechny SUPREME // Sąd Najwyższy ADMINISTRATIVE // sąd administracyjny CONSTITUTIONAL_TRIBUNAL // Trybunał Konstytucyjny NATIONAL_APPEAL_CHAMBER // Krajowa Izba Odwoławcza
|
Typ organu orzekającego. |
| courtCases | Lista | Sprawy związane z orzeczeniem. Orzeczenie czasem może dotyczyć wielu spraw (np. orzeczenia KIO). | |
| courtCases[i].caseNumber | Tekst | Sygnatura sprawy. | |
| judgmentType | Słownik |
DECISION // postanowienie RESOLUTION // uchwała SENTENCE // wyrok REGULATION // zarządzenie REASONS // uzasadnienie, system źródłowy orzeczeń sądów powszechnych czasem dzieli orzeczenie na dwa odrębne: orzeczenie i jego uzasadnienie |
Typ orzeczenia |
| judges | Lista | Sędziowie orzekający. | |
| judges[i].name | Tekst | Imię i nazwisko sędziego. | |
| judges[i].function | Tekst | Funkcja sędziego definiowana przede wszystkim w orzeczeniach Sądu Najwyższego. Np. SSN - Sędzia Sądu Najwyższego. | |
| judges[i].specialRoles | Słownik |
|
Specjalna rola sędziego na rozprawie. |
| textContent | Tekst | Wycinek treści orzeczenia (zawierający oznaczone znacznikiem <em> szukane frazy). | |
| keywords | Lista/ słownik | Listę możliwych słów kluczowych można pobrać za pomocą odpowiedniego serwisu spoza oficjalnego API, więcej: Dodatkowe serwisy | Słowa kluczowe/ hasła tematyczne przypisane do orzeczenia. Obecnie dostępne tylko dla orzeczeń pobieranych ze źródłowego systemu sądów powszechnych. |
| division // sąd powszechny | Obiekt | Orzekający wydział sądu powszechnego. Tylko dla orzeczeń sądów powszechnych. W dalszej części opisany obiekt division dla Sądu Najwyższego. | |
| division.href | Url | Odnośnik do szczegółowych danych wydziału. Zobacz: API przeglądania danych | |
| division.id | Liczba całkowita | >0 | Identyfikator wydziału w systemie SAOS. |
| division.name | Tekst | Nazwa wydziału. | |
| division.code | Tekst | Kod wydziału w systemie źródłowym. | |
| division.court | Obiekt | Sąd powszechny wydający dane orzeczenie. | |
| division.court.href | Url | Odnośnik do szczegółowych danych sądu. Zobacz: API przeglądania danych | |
| division.court.id | Liczba całkowita | >0 | Identyfikator sądu w systemie SAOS. |
| division.court.code | Tekst | Kod sądu w systemie źródłowym. | |
| division.court.name | Tekst | Pełna nazwa sądu. | |
| judgmentDate | Data | Data w formacie: yyyy-MM-dd | Data orzeczenia. |
| personnelType | Słownik |
ONE_PERSON // skład jednoosobowy THREE_PERSON // trzyosobowy FIVE_PERSON // pięcioosobowy SEVEN_PERSON // siedmioosobowy ALL_COURT // skład całego Sądu Najwyższego ALL_CHAMBER // skład pełnej izby JOINED_CHAMBERS // skład połączonych izb |
Typ orzekającego składu sędziowskiego. Tylko dla orzeczeń Sądu Najwyższego. |
| judgmentForm | Słownik |
Lista dostępnych form orzeczenia można pobrać za pomocą odpowiedniego serwisu spoza oficjalnego API, więcej: Dodatkowe serwisy |
Forma orzeczenia. Tylko dla orzeczeń Sądu Najwyższego. Przykładowa forma: wyrok SN. |
| division // Sąd Najwyższy | Obiekt | Orzekający wydział izby Sądu Najwyższego. Tylko dla Sądu Najwyższego. Wcześniej opisany obiekt division dla orzeczeń sądów powszechnych. | |
| division.href | Url | Odnośnik do szczegółowych danych wydziału. Zobacz: API przeglądania danych | |
| division.id | Liczba całkowita | >0 | Identyfikator wydziału izby Sądu Najwyższego w SAOS prowadzącego sprawę. |
| division.name | Tekst | Nazwa wydziału. | |
| division.chambers | Lista | Izby Sądu Najwyższego orzekające w sprawie. W prawie wszystkich orzeczeniach izba jest tylko jedna, ale jest kilka orzeczeń, do których przypisane są dwie izby. | |
| division.chambers[i].href | Url | Odnośnik do szczegółowych danych izby. Zobacz: API przeglądania danych | |
| division.chambers[i].id | Liczba całkowita | >0 | Identyfikator izby Sądu Najwyższego w SAOS. |
| division.chambers[i].name | Tekst | Nazwa izby. |