SAOS API

https://www.saos.org.pl/help/index.php/dokumentacja-api/
Admin
SAOS API to interfejs programistyczny umożliwiający przeszukiwanie oraz pobieranie danych o wyrokach...
Tokens:10,800
Snippets:55
Trust Score:9.1
Update:2 months ago
Show doc for...
Tokens:
Raw
### GET https://www.saos.org.pl/api/dump

Source: https://www.saos.org.pl/help/index.php/dokumentacja-api/api-pobierania-danych

Punkt wejścia API publikujący listę dostępnych serwisów pobierania danych.

```APIDOC
## GET https://www.saos.org.pl/api/dump

### Opis
Publikuje listę serwisów pobierania poszczególnych typów danych: słownika sądów powszechnych, słownika izb Sądu Najwyższego, orzeczeń oraz dodatkowych metadanych orzeczeń.
```

--------------------------------

### GET /api

Source: https://www.saos.org.pl/help/index.php/dokumentacja-api/informacje-ogolne

The main entry point for the API, providing a list of links to lower-level services such as data retrieval and search APIs.

```APIDOC
## GET /api

### Description
This is the root entry point of the API. It provides a list of links to available sub-services, including data retrieval and data search APIs.

### Method
GET

### Endpoint
www.saos.org.pl/api
```

--------------------------------

### GET /sc/judgmentForms/list

Source: https://www.saos.org.pl/help/index.php/dokumentacja-api/dodatkowe-serwisy

Pobiera listę dostępnych form orzeczeń Sądu Najwyższego.

```APIDOC
## GET https://www.saos.org.pl/sc/judgmentForms/list

### Description
Pozwala na pobranie listy możliwych form orzeczeń Sądu Najwyższego (id, nazwa).

### Method
GET

### Endpoint
https://www.saos.org.pl/sc/judgmentForms/list

### Response
- **id** (Liczba całkowita) - Identyfikator formy orzeczenia w systemie SAOS
- **name** (Tekst) - Nazwa formy orzeczenia
```

--------------------------------

### GET /keywords/COMMON/{KEYWORD_START}

Source: https://www.saos.org.pl/help/index.php/dokumentacja-api/dodatkowe-serwisy

Pozwala na przeszukiwanie bazy słów kluczowych orzeczeń sądów powszechnych. Może być wykorzystane np. w polach autocompletion.

```APIDOC
## GET /keywords/COMMON/{KEYWORD_START}

### Description
Pozwala na przeszukiwanie bazy słów kluczowych orzeczeń sądów powszechnych. Przykład zastosowania: pole autocompletion wyboru słowa kluczowego.

### Method
GET

### Endpoint
https://www.saos.org.pl/keywords/COMMON/{KEYWORD_START}

### Parameters
#### Path Parameters
- **KEYWORD_START** (string) - Required - Początek słowa kluczowego; będą wyszukane tylko słowa kluczowe rozpoczynające się na podaną frazę.

### Response
#### Success Response (200)
- **id** (integer) - Identyfikator słowa kluczowego w systemie SAOS.
- **name** (string) - Słowo kluczowe.
```

--------------------------------

### GET /sc/chambers/list

Source: https://www.saos.org.pl/help/index.php/dokumentacja-api/dodatkowe-serwisy

Pobiera listę izb Sądu Najwyższego wraz z ich identyfikatorami i nazwami.

```APIDOC
## GET https://www.saos.org.pl/sc/chambers/list

### Description
Pozwala na pobranie listy izb Sądu Najwyższego z podstawowymi danymi (id, nazwa).

### Method
GET

### Endpoint
https://www.saos.org.pl/sc/chambers/list

### Response
- **id** (Liczba całkowita) - Identyfikator izby w systemie SAOS
- **name** (Tekst) - Nazwa izby
```

--------------------------------

### GET /analysis/generate

Source: https://www.saos.org.pl/help/index.php/dokumentacja-api/dodatkowe-serwisy

Pozwala na wygenerowanie wykresów liczby lub procentu orzeczeń w funkcji czasu oraz w podziale na sądy powszechne.

```APIDOC
## GET /analysis/generate

### Description
Pozwala na wygenerowanie wykresów liczby/procentu orzeczeń (spełniających zadane kryteria) w funkcji czasu oraz w podziale na sądy powszechne.

### Method
GET

### Endpoint
https://www.saos.org.pl/analysis/generate

### Parameters
#### Query Parameters
- **seriesFilters[seriesIndex].phrase** (string) - Optional - Fraza poszukiwana we wszystkich polach orzeczenia.
- **ysettings.valueType** (string) - Required - Jednostka osi y (NUMBER, PERCENT, NUMBER_PER_1000).
- **globalFilter.judgmentDateRange.startYear** (integer) - Required - Rok dolnego ograniczenia daty orzeczenia.
- **globalFilter.judgmentDateRange.startMonth** (integer) - Required - Miesiąc dolnego ograniczenia daty orzeczenia.
- **globalFilter.judgmentDateRange.endYear** (integer) - Required - Rok górnego ograniczenia daty orzeczenia.
- **globalFilter.judgmentDateRange.endMonth** (integer) - Required - Miesiąc górnego ograniczenia daty orzeczenia.
- **globalFilter.courtCriteria.courtType** (string) - Optional - Typ sądu powszechnego (APPEAL, REGIONAL, DISTRICT).
- **globalFilter.courtCriteria.ccCourtId** (integer) - Optional - Identyfikator wewnętrzny sądu powszechnego.
- **globalFilter.courtCriteria.ccDivisionId** (integer) - Optional - Identyfikator wewnętrzny wydziału sądu powszechnego.
- **globalFilter.courtCriteria.ccIncludeDependentCourtJudgments** (boolean) - Optional - Czy uwzględnić orzeczenia sądów podrzędnych.
- **globalFilter.courtCriteria.scChamberId** (integer) - Optional - Identyfikator wewnętrzny izby Sądu Najwyższego.
- **globalFilter.courtCriteria.scDivisionId** (integer) - Optional - Identyfikator wewnętrzny wydziału izby SN.
```

--------------------------------

### GET https://www.saos.org.pl/api/dump/enrichments

Source: https://www.saos.org.pl/help/index.php/dokumentacja-api/api-pobierania-danych

Pobiera listę etykiet wygenerowanych przez moduł wzbogacania danych z możliwością określenia rozmiaru strony oraz numeru strony.

```APIDOC
## GET https://www.saos.org.pl/api/dump/enrichments

### Description
Umożliwia pobranie listy etykiet wygenerowanych przez moduł wzbogacania danych.

### Method
GET

### Endpoint
https://www.saos.org.pl/api/dump/enrichments

### Parameters
#### Query Parameters
- **pageSize** (liczba całkowita) - Opcjonalny - Maksymalna liczba elementów na stronie (wartość domyślna: 20, zakres: 10-100)
- **pageNumber** (liczba całkowita) - Opcjonalny - Numer żądanej strony (wartość domyślna: 0, zakres: >=0)
```

--------------------------------

### Retrieve and display judgment statistics

Source: https://www.saos.org.pl/help/index.php/dokumentacja-api

Uses jQuery to perform an AJAX GET request to the SAOS analysis endpoint and populates an HTML table with the returned data. Note that this example utilizes a non-official API service.

```javascript
$(function(){  
	     
      $("#murderJudgmentsButton").click(function() {  
  
         $.ajax({  
	    method: "GET",  
            url: "https://www.saos.org.pl/analysis/generate?globalFilter.courtCriteria.courtType=COMMON&globalFilter.courtCriteria.ccIncludeDependentCourtJudgments=true&globalFilter.judgmentDateRange.startMonth=1&globalFilter.judgmentDateRange.startYear=2013&globalFilter.judgmentDateRange.endMonth=12&globalFilter.judgmentDateRange.endYear=2015&seriesFilters[0].phrase=morderstwo or zabójstwo&ysettings.valueType=NUMBER"  
         })  
	 .done(function(data) {  
	    var chart = data.charts.CC_COURT_CHART;   
            $("#murderJudgments").append("<tbody></tbody>");  
		      
	    for (var i=0; i<chart.seriesList[0].points.length; i++) {  
                var xtick = chart.xticks[i];	      
                var judgmentCount = chart.seriesList[0].points[i][1];  
                $("#murderJudgments").find("tbody").append("<tr><td>"+xtick[1].name+"</td><td>"+judgmentCount+"</td></tr>");  
        }  
        $("#murderJudgmentsButton").remove();  
  
     });  
     });  
  
  });  
// ]]></script>  
<h5>Liczba orzeczeń ze słowem 'zabójstwo' lub 'morderstwo' w latach 2013-2015 w podziale na apelacje</h5>  
<p><button id="murderJudgmentsButton">Pobierz</button></p>  
<table id="murderJudgments" class="table"></table>
```

--------------------------------

### GET /api/scChambers/{SC_CHAMBER_ID}

Source: https://www.saos.org.pl/help/index.php/dokumentacja-api/api-przegladania-danych

Pobiera szczegółowe informacje o wybranej izbie Sądu Najwyższego, w tym jej nazwę oraz listę wydziałów.

```APIDOC
## GET https://www.saos.org.pl/api/scChambers/{SC_CHAMBER_ID}

### Description
Umożliwia pobranie szczegółów wybranej izby Sądu Najwyższego (nazwy, listy wydziałów).

### Method
GET

### Endpoint
https://www.saos.org.pl/api/scChambers/{SC_CHAMBER_ID}

### Parameters
#### Path Parameters
- **SC_CHAMBER_ID** (Liczba całkowita) - Required - Wewnętrzny identyfikator izby Sądu Najwyższego w SAOS

### Response
#### Success Response (200)
- **id** (Liczba całkowita) - Identyfikator izby w systemie SAOS
- **href** (Url) - Url API z pełnymi danymi izby
- **name** (Tekst) - Pełna nazwa izby
- **divisions** (Lista) - Wydziały izby
- **divisions[i].id** (Liczba całkowita) - Identyfikator wydziału w systemie SAOS
- **divisions[i].href** (Url) - Url API z pełnymi danymi wydziału
- **divisions[i].name** (Tekst) - Nazwa wydziału
```

--------------------------------

### GET /sc/chambers/{SC_CHAMBER_ID}/chamberDivisions/list

Source: https://www.saos.org.pl/help/index.php/dokumentacja-api/dodatkowe-serwisy

Pobiera listę wydziałów dla konkretnej izby Sądu Najwyższego.

```APIDOC
## GET https://www.saos.org.pl/sc/chambers/{SC_CHAMBER_ID}/chamberDivisions/list

### Description
Pozwala na pobranie listy wydziałów izby Sądu Najwyższego z podstawowymi danymi (id, nazwa).

### Method
GET

### Endpoint
https://www.saos.org.pl/sc/chambers/{SC_CHAMBER_ID}/chamberDivisions/list

### Parameters
#### Path Parameters
- **SC_CHAMBER_ID** (Liczba całkowita) - Wewnętrzny identyfikator izby Sądu Najwyższego w SAOS

### Response
- **id** (Liczba całkowita) - Identyfikator wydziału w systemie SAOS
- **name** (Tekst) - Nazwa wydziału
```

--------------------------------

### GET https://www.saos.org.pl/api/dump/scChambers

Source: https://www.saos.org.pl/help/index.php/dokumentacja-api/api-pobierania-danych

Retrieves a list of Supreme Court chambers.

```APIDOC
## GET https://www.saos.org.pl/api/dump/scChambers

### Description
Umożliwia pobranie listy izb Sądu Najwyższego.

### Method
GET

### Endpoint
https://www.saos.org.pl/api/dump/scChambers

### Parameters
#### Query Parameters
- **pageSize** (liczba całkowita) - Optional - Maksymalna liczba izb na stronie (pobieranych przez jedno żądanie). Domyślnie: 20, zakres: >=10 i =<100.
- **pageNumber** (liczba całkowita) - Optional - Numer żądanej strony. Domyślnie: 0, zakres: >=0.

### Response
#### Success Response (200)
- **items** (Obiekt) - Lista izb zawierająca id, name oraz listę divisions (id, name, fullName).
```

--------------------------------

### GET /api/scDivisions/{SC_DIVISION_ID}

Source: https://www.saos.org.pl/help/index.php/dokumentacja-api/api-przegladania-danych

Pobiera szczegółowe informacje o wybranym wydziale izby Sądu Najwyższego, w tym nazwę oraz powiązania z izbą.

```APIDOC
## GET https://www.saos.org.pl/api/scDivisions/{SC_DIVISION_ID}

### Description
Umożliwia pobranie szczegółów wybranego wydziału izby Sądu Najwyższego (nazwy, izby, do której należy itp.).

### Method
GET

### Endpoint
https://www.saos.org.pl/api/scDivisions/{SC_DIVISION_ID}

### Parameters
#### Path Parameters
- **SC_DIVISION_ID** (Liczba całkowita) - Required - Wewnętrzny identyfikator wydziału izby Sądu Najwyższego w SAOS

### Response
#### Success Response (200)
- **id** (Liczba całkowita) - Identyfikator wydziału w systemie SAOS
- **href** (Url) - Url API z pełnymi danymi wydziału
- **name** (Tekst) - Nazwa wydziału
- **fullName** (Tekst) - Pełna nazwa wydziału
- **chamber** (Obiekt) - Izba, do której należy wydział
- **chamber.id** (Liczba całkowita) - Identyfikator izby w systemie SAOS
- **chamber.href** (Url) - Url API z pełnymi danymi izby
- **chamber.name** (Tekst) - Nazwa izby
```

--------------------------------

### GET https://www.saos.org.pl/cc/courts/list

Source: https://www.saos.org.pl/help/index.php/dokumentacja-api/dodatkowe-serwisy

Pobiera listę sądów powszechnych wraz z ich podstawowymi danymi, takimi jak identyfikator, nazwa oraz typ sądu.

```APIDOC
## GET https://www.saos.org.pl/cc/courts/list

### Description
Pozwala na pobranie listy sądów powszechnych z podstawowymi danymi (id, nazwa, typ).

### Method
GET

### Endpoint
https://www.saos.org.pl/cc/courts/list

### Response
#### Success Response (200)
- **id** (Liczba całkowita) - Identyfikator sądu w systemie SAOS
- **name** (Tekst) - Nazwa sądu
- **type** (Słownik) - Typ sądu powszechnego (APPEAL, REGIONAL, DISTRICT)
```

--------------------------------

### Publikacja listy orzeczeń według ustawy

Source: https://www.saos.org.pl/help/index.php/dokumentacja-api

Pobiera i wyświetla listę 10 ostatnich orzeczeń powiązanych z konkretnym aktem prawnym przy użyciu zapytania GET.

```javascript
<script>  
$(function(){  
   $.ajax({  
      method: "GET",  
      url: "https://www.saos.org.pl/api/search/judgments?pageSize=10&pageNumber=0&sortingField=JUDGMENT_DATE&courtType=COMMON&lawJournalEntryCode=2011/112&sortingDirection=DESC"  
  })  
  .done(function(data) {  
      for (var i=0; i<data.items.length; i++) {  
      var judgment = data.items[i];  
      $("#lawJournalJudgments").append("<li><a href='https://www.saos.org.pl/judgments/"+judgment.id+"'>"+judgment.judgmentDate+", "+judgment.courtCases[0].caseNumber+", " + judgment.division.court.name +"</a></li>");  
   }  
   });  
});  
</script>  
  
<h3>Ostatnie 10 orzeczeń odwołujących się do 'Ustawa z dnia 5 stycznia 2011 r. Kodeks wyborczy (Dz. U. z 2011 r. Nr 21, poz. 112)'</h3>  
<ul id="lawJournalJudgments">  
</ul>
```

--------------------------------

### GET /search/lawJournalEntries

Source: https://www.saos.org.pl/help/index.php/dokumentacja-api/dodatkowe-serwisy

Wyszukuje pozycje dziennika ustaw dostępne w systemie SAOS.

```APIDOC
## GET https://www.saos.org.pl/search/lawJournalEntries

### Description
Pozwala na wyszukiwanie pozycji dziennika ustaw spośród tych, które dostępne są w SAOS.

### Method
GET

### Endpoint
https://www.saos.org.pl/search/lawJournalEntries

### Parameters
#### Query Parameters
- **pageSize** (Liczba całkowita) - Opcjonalny - Maksymalna liczba elementów na stronie (domyślnie 20)
- **pageNumber** (Liczba całkowita) - Opcjonalny - Numer żądanej strony (domyślnie 0)
- **year** (Liczba całkowita) - Opcjonalny - Rok dziennika ustaw
- **journalNo** (Liczba całkowita) - Opcjonalny - Numer dziennika ustaw
- **entry** (Liczba całkowita) - Opcjonalny - Numer pozycji w dzienniku ustaw
- **text** (Tekst) - Opcjonalny - Tytuł pozycji w dzienniku ustaw

### Request Example
https://www.saos.org.pl/search/lawJournalEntries?year=2008&journalNo=&entry=&text=&pageSize=10&pageNumber=0

### Response
- **id** (Liczba całkowita) - Identyfikator pozycji dziennika ustaw
- **code** (Tekst) - Numer dziennika ustaw w formacie: rok/nr pozycji
- **year** (Liczba całkowita) - Rok dziennika ustaw
- **journalNo** (Liczba całkowita) - Numer dziennika ustaw
- **entry** (Liczba całkowita) - Numer pozycji w dzienniku ustaw
- **title** (Tekst) - Nazwa formy orzeczenia
```

--------------------------------

### GET https://www.saos.org.pl/api/dump/judgments

Source: https://www.saos.org.pl/help/index.php/dokumentacja-api/api-pobierania-danych

Retrieves the full database of judicial rulings with support for filtering and synchronization.

```APIDOC
## GET https://www.saos.org.pl/api/dump/judgments

### Description
Umożliwia pobranie całej bazy orzeczeń.

### Method
GET

### Endpoint
https://www.saos.org.pl/api/dump/judgments

### Parameters
#### Query Parameters
- **pageSize** (liczba całkowita) - Optional - Maksymalna liczba elementów na stronie. Domyślnie: 20, zakres: >=10 i =<100.
- **pageNumber** (liczba całkowita) - Optional - Numer żądanej strony. Domyślnie: 0, zakres: >=0.
- **judgmentStartDate** (Data) - Optional - Dolne ograniczenie daty orzeczenia (yyyy-MM-dd).
- **judgmentEndDate** (Data) - Optional - Górne ograniczenie daty orzeczenia (yyyy-MM-dd).
- **sinceModificationDate** (Data z czasem) - Optional - Data ostatniej modyfikacji orzeczenia (yyyy-MM-dd'T'HH:mm:ss.SSS). Służy do synchronizacji danych.
- **withGenerated** (Boolean) - Optional - Określa, czy dane mają zawierać wygenerowane przez moduł wzbogacający. Domyślnie: true.

### Response
#### Success Response (200)
- **items** (Obiekt) - Lista orzeczeń zawierająca szczegółowe dane takie jak id, courtType, courtCases, judgmentType, judges, source, decision, summary, textContent, legalBases, oraz referencedRegulations.
```

--------------------------------

### GET https://www.saos.org.pl/cc/courts/{CC_COURT_ID}/courtDivisions/list

Source: https://www.saos.org.pl/help/index.php/dokumentacja-api/dodatkowe-serwisy

Pobiera listę wydziałów dla konkretnego sądu powszechnego na podstawie jego identyfikatora.

```APIDOC
## GET https://www.saos.org.pl/cc/courts/{CC_COURT_ID}/courtDivisions/list

### Description
Pozwala na pobranie listy wydziałów sądu powszechnego z podstawowymi danymi (id, nazwa).

### Method
GET

### Endpoint
https://www.saos.org.pl/cc/courts/{CC_COURT_ID}/courtDivisions/list

### Parameters
#### Path Parameters
- **CC_COURT_ID** (Liczba całkowita) - Wymagany - Wewnętrzny identyfikator sądu powszechnego w SAOS

### Response
#### Success Response (200)
- **id** (Liczba całkowita) - Identyfikator wydziału w systemie SAOS
- **name** (Tekst) - Nazwa wydziału
```

--------------------------------

### GET /api/commonCourts/{CC_COURT_ID}

Source: https://www.saos.org.pl/help/index.php/dokumentacja-api/api-przegladania-danych

Pobiera szczegółowe informacje o wybranym sądzie powszechnym, w tym jego nazwę, typ, kod oraz listę przypisanych wydziałów.

```APIDOC
## GET /api/commonCourts/{CC_COURT_ID}

### Description
Umożliwia pobranie szczegółów wybranego sądu powszechnego (nazwy, typu, listy wydziałów itp.).

### Method
GET

### Endpoint
https://www.saos.org.pl/api/commonCourts/{CC_COURT_ID}

### Parameters
#### Path Parameters
- **CC_COURT_ID** (Integer) - Required - Wewnętrzny identyfikator sądu powszechnego w SAOS

### Response
#### Success Response (200)
- **id** (Integer) - Identyfikator sądu w systemie SAOS
- **href** (Url) - Url API z pełnymi danymi sądu
- **name** (String) - Nazwa sądu
- **code** (String) - Kod sądu w systemie źródłowym
- **type** (String) - Typ sądu (APPEAL, REGIONAL, DISTRICT)
- **parentCourt** (Object) - Sąd nadrzędny dla danego sądu powszechnego
- **divisions** (List) - Wydziały sądu powszechnego
```

--------------------------------

### GET /api/ccDivisions/{CC_DIVISION_ID}

Source: https://www.saos.org.pl/help/index.php/dokumentacja-api/api-przegladania-danych

Pobiera szczegółowe informacje o wybranym wydziale sądu powszechnego, w tym jego nazwę, typ oraz powiązany sąd.

```APIDOC
## GET /api/ccDivisions/{CC_DIVISION_ID}

### Description
Umożliwia pobranie szczegółów wybranego wydziału sądu powszechnego (nazwy, typu, sądu itp.).

### Method
GET

### Endpoint
https://www.saos.org.pl/api/ccDivisions/{CC_DIVISION_ID}

### Parameters
#### Path Parameters
- **CC_DIVISION_ID** (Integer) - Required - Wewnętrzny identyfikator wydziału sądu powszechnego w SAOS

### Response
#### Success Response (200)
- **id** (Integer) - Identyfikator wydziału w systemie SAOS
- **href** (Url) - Url API z pełnymi danymi wydziału
- **name** (String) - Nazwa wydziału
- **code** (String) - Kod wydziału w systemie źródłowym
- **type** (String) - Typ wydziału
- **court** (Object) - Sąd, do którego należy wydział
```

--------------------------------

### GET https://www.saos.org.pl/api/dump/commonCourts

Source: https://www.saos.org.pl/help/index.php/dokumentacja-api/api-pobierania-danych

Serwis umożliwiający pobranie danych sądów powszechnych, w tym nazw, miejscowości oraz list wydziałów.

```APIDOC
## GET https://www.saos.org.pl/api/dump/commonCourts

### Opis
Umożliwia pobranie danych sądów powszechnych (nazw, miejscowości, list wydziałów itd.).

### Parametry
#### Query Parameters
- **pageSize** (liczba całkowita) - Opcjonalny - Maksymalna liczba sądów na stronie (domyślnie 20, zakres 10-100)
- **pageNumber** (liczba całkowita) - Opcjonalny - Numer żądanej strony (domyślnie 0)

### Response
#### Success Response (200)
- **items** (Obiekt) - Lista sądów zawierająca pola: id, code, name, type, divisions.
```

--------------------------------

### GET https://www.saos.org.pl/api/judgments/JUDGMENT_ID

Source: https://www.saos.org.pl/help/index.php/dokumentacja-api/api-przegladania-danych

Umożliwia pobranie szczegółów pojedynczego orzeczenia, w tym metadanych oraz pełnej treści.

```APIDOC
## GET https://www.saos.org.pl/api/judgments/JUDGMENT_ID

### Description
Umożliwia pobranie szczegółów pojedynczego orzeczenia (metadanych, treści).

### Method
GET

### Endpoint
https://www.saos.org.pl/api/judgments/JUDGMENT_ID

### Parameters
#### Path Parameters
- **JUDGMENT_ID** (Tekst) - Required - wewnętrzny identyfikator orzeczenia w SAOS

### Response
#### Success Response (200)
- **id** (Liczba całkowita) - Identyfikator orzeczenia w systemie SAOS
- **courtType** (Słownik) - Typ organu orzekającego
- **href** (Url) - Url API z pełnymi danymi orzeczenia
- **courtCases** (Lista) - Sprawy związane z orzeczeniem
- **judgmentType** (Słownik) - Typ orzeczenia
- **judgmentDate** (Data) - Data orzeczenia (yyyy-MM-dd)
- **judges** (Lista) - Sędziowie orzekający
- **source** (Obiekt) - Informacje na temat źródła orzeczenia
- **courtReporters** (Lista) - Protokolanci biorący udział w sprawie
- **decision** (Tekst) - Rozstrzygnięcie sprawy
- **summary** (Tekst) - Podsumowanie
- **textContent** (Tekst) - Pełny tekst orzeczenia
- **legalBases** (Lista) - Podstawy prawne orzeczenia
- **referencedRegulations** (Lista) - Powołane przepisy
- **keywords** (Lista) - Słowa kluczowe/hasła tematyczne
- **referencedCourtCases** (Lista) - Sprawy przywołane w treści orzeczenia
```

--------------------------------

### GET /api/search/judgments

Source: https://www.saos.org.pl/help/index.php/dokumentacja-api/api-przeszukiwania-danych

Umożliwia przeszukiwanie bazy orzeczeń wg zadanych parametrów. Pozwala napisać skrypt lub aplikację kliencką korzystającą z bazy orzeczeń SAOS.

```APIDOC
## GET https://www.saos.org.pl/api/search/judgments

### Description
Umożliwia przeszukiwanie bazy orzeczeń wg zadanych parametrów.

### Method
GET

### Endpoint
https://www.saos.org.pl/api/search/judgments

### Parameters
#### Query Parameters
- **pageSize** (Liczba całkowita) - Optional - Maksymalna liczba elementów na stronie (domyślnie 20, zakres 10-100)
- **pageNumber** (Liczba całkowita) - Optional - Numer żądanej strony (domyślnie 0)
- **sortingField** (Słownik) - Optional - Pole sortowania (domyślnie DATABASE_ID)
- **sortingDirection** (Słownik) - Optional - Kierunek sortowania (ASC lub DESC, domyślnie ASC)
- **all** (Tekst) - Optional - Fraza poszukiwana we wszystkich polach
- **legalBase** (Tekst) - Optional - Podstawa prawna
- **referencedRegulation** (Tekst) - Optional - Powołany przepis
- **lawJournalEntryCode** (Tekst) - Optional - Pozycja dziennika ustaw
- **judgeName** (Tekst) - Optional - Imię i nazwisko sędziego
- **caseNumber** (Tekst) - Optional - Sygnatura akt sprawy
- **courtType** (Słownik) - Optional - Typ sądu (APPEAL, REGIONAL, DISTRICT)
- **ccCourtId** (Liczba całkowita) - Optional - Identyfikator wewnętrzny sądu
- **ccCourtCode** (Tekst) - Optional - Kod sądu
- **ccCourtName** (Tekst) - Optional - Pełna nazwa sądu
- **ccDivisionId** (Liczba całkowita) - Optional - Identyfikator wewnętrzny wydziału
- **ccDivisionCode** (Tekst) - Optional - Kod wydziału
- **ccDivisionName** (Tekst) - Optional - Pełna nazwa wydziału
```

--------------------------------

### Włączenie biblioteki jQuery

Source: https://www.saos.org.pl/help/index.php/dokumentacja-api

Wymagane umieszczenie linku do biblioteki jQuery w sekcji head strony przed użyciem przykładów korzystających z AJAX.

```html
<script src="//code.jquery.com/jquery-1.11.3.min.js">
```

--------------------------------

### Pobieranie orzeczeń po kliknięciu przycisku

Source: https://www.saos.org.pl/help/index.php/dokumentacja-api

Pobiera 10 ostatnich orzeczeń zawierających określone słowo kluczowe w treści po aktywacji zdarzenia kliknięcia przycisku.

```javascript
<script>  
   $(function(){  
	     
      $("#scooterJudgmentsButton").click(function() {  
  
         $.ajax({  
            method: "GET",  
            url: "https://www.saos.org.pl/api/search/judgments?pageSize=10&pageNumber=0&all=hulajnoga&sortingField=JUDGMENT_DATE&sortingDirection=DESC"  
         })  
         .done(function(data) {  
            for (var i=0; i<data.items.length; i++) {  
               var judgment = data.items[i];  
               $("#scooterJudgments").append("<li><a href='https://www.saos.org.pl/judgments/"+judgment.id+"'>"+judgment.judgmentDate+", "+judgment.courtCases[0].caseNumber+", " + judgment.division.court.name+"</a>"  
                                            + "<p>..."+judgment.textContent+"...</p>"  
                                            +"</li>");  
        }  
        $("#scooterJudgmentsButton").remove();  
  
     });  
     });  
  
  });  
</script>  
  
<h5>Ostatnie 10 orzeczeń z hasłem 'hulajnoga' w treści orzeczenia</h5>  
<button id="scooterJudgmentsButton">Pobierz</button>  
  
<ul id="scooterJudgments">  
</ul>  
  
  
  });
```

--------------------------------

### Struktura poprawnej odpowiedzi API

Source: https://www.saos.org.pl/help/index.php/dokumentacja-api/informacje-ogolne

Przykład poprawnej odpowiedzi JSON zawierającej odnośniki, listę wyników, szablon zapytania oraz informacje o wynikach.

```json
{
  "links": [  
     {"rel": "self","href": "https://www.saos.org.pl/api/dump/judgments?pageSize=20&pageNumber=0"},  
     {"rel": "next","href": "https://www.saos.org.pl/api/dump/judgments?pageSize=20&pageNumber=1"}
 ],  
  
  "items": [  
    {"id": 76452,"courtType": "SUPREME","courtCases": ...},  
    ...
 ],  
  
 "queryTemplate":   
   {"pageSize": {"value": 20,"description": "Represents maximum number...","allowedValues": "Any integer greater..."},
     "sortingField": ["DATABASE_ID","JUDGMENT_DATE","CASE_NUMBER"],
   },
  
 "info" : {  
    "totalResults" : 178765  
  }
}
```

--------------------------------

### Struktura obiektu xticks dla wykresu sądów powszechnych

Source: https://www.saos.org.pl/help/index.php/dokumentacja-api/dodatkowe-serwisy

Przykładowy obiekt zawierający informacje o sądzie dla wykresu CC_COURT_CHART.

```json
{
    "courtId": 34,
    "name": "Sąd Apelacyjny w Białymstoku"
}
```

--------------------------------

### Struktura obiektu analysisForm

Source: https://www.saos.org.pl/help/index.php/dokumentacja-api/dodatkowe-serwisy

Przykładowa postać obiektu zawierającego parametry wywołania serwisu.

```json
"analysisForm": {
    "seriesFilters": [
        {
            "phrase": null
        }
    ],
    "globalFilter": {
        "judgmentDateRange": {
            "startMonth": 1,
            "startYear": 1995,
            "endMonth": 6,
            "endYear": 2015
        },
        "courtCriteria": {
            "courtType": "COMMON",
            "ccCourtId": null,
            "ccIncludeDependentCourtJudgments": false,
            "ccCourtDivisionId": null,
            "scCourtChamberId": null,
            "scCourtChamberDivisionId": null
        }
    },
    "ysettings": {
        "valueType": "NUMBER"
    }
}
```

--------------------------------

### Struktury danych xticks dla wykresu głównego

Source: https://www.saos.org.pl/help/index.php/dokumentacja-api/dodatkowe-serwisy

Przykłady obiektów xticks reprezentujących różne przedziały czasowe (rok, miesiąc, dzień) na osi x wykresu głównego.

```json
{
    "startYear": 2010,
    "endYear": 2010,
    "period": "YEAR"
}
```

```json
{
    "startYear": 2010,
    "startMonthOfYear": 7,
    "endYear": 2010,
    "endMonthOfYear": 12,
    "period": "MONTH"
}
```

```json
{
    startDay: {
        "dayOfMonth": 26,
        "monthOfYear": 2,
        "year": 2010,
    },
    endDay: {
        "dayOfMonth": 4,
        "monthOfYear": 3,
        "year": 2010,
    },
    "period": "DAY"
}
```

--------------------------------

### Fetch judgments with Java RestTemplate

Source: https://www.saos.org.pl/help/index.php/dokumentacja-api

Uses Spring's RestTemplate to retrieve the 10 most recent common court judgments. Requires the spring-web dependency.

```java
package rest;  
  
import java.util.ArrayList;  
import java.util.List;  
  
import org.springframework.http.HttpEntity;  
import org.springframework.http.HttpHeaders;  
import org.springframework.http.HttpMethod;  
import org.springframework.http.MediaType;  
import org.springframework.http.ResponseEntity;  
import org.springframework.web.client.RestTemplate;  
  
public class RestClient {  
  
      
    public static void main(String[] args) {  
          
        String url = "https://www.saos.org.pl/api/search/judgments?pageSize=10&courtType=COMMON&sortingField=JUDGMENT_DATE&sortingDirection=DESC";  
          
        HttpHeaders headers = new HttpHeaders();  
        List<MediaType> mediaTypes = new ArrayList<>();  
        mediaTypes.add(MediaType.APPLICATION_JSON);  
        headers.setAccept(mediaTypes);  
      
        RestTemplate restTemplate = new RestTemplate();  
         
        ResponseEntity<String> response = restTemplate.exchange(url, HttpMethod.GET, new HttpEntity<String>(headers), String.class);  
          
        System.out.println(response);  
    }  
}
```

--------------------------------

### Struktura odpowiedzi błędu

Source: https://www.saos.org.pl/help/index.php/dokumentacja-api/informacje-ogolne

Przykład odpowiedzi JSON zwracanej w przypadku niepoprawnego przetworzenia żądania.

```json
{
"error": {  
    "httpStatus": "400",   
    "reason": "WRONG REQUEST PARAMETER",   
    "propertyName": "pageSiz",   
    "message": "parameter 'pageSiz' :  name is incorrect" }
}
```
Tokens:
Raw