Dodatkowe serwisy

Wprowadzenie

W systemie SAOS dostępne są serwisy, które nie zostały dotychczas włączone do oficjalnego API, a które są dostępne jako serwisy REST. Z serwisów tych korzysta moduł webowy SAOS. Jeśli któryś z tych serwisów chciałbyś wykorzystać, nie ma ku temu przeszkód. Musisz jednak mieć świadomość, że dopóki nie są one częścią oficjalnego API, mogą się zmieniać, a niektóre zmiany (jak np. url lub struktura json odpowiedzi) mogą spowodować, że twój kod korzystający z tych serwisów przestanie działać. Ryzyko zmian niżej opisanych serwisów jest na razie skrajnie małe, ale być może kiedyś w przyszłości zostaną one włączone do oficjalnego API i wtedy pewne zmiany (np. url) nastąpią.

Lista sądów powszechnych

Adres

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

Opis

Pozwala na pobranie listy sądów powszechnych z podstawowymi danymi (id, nazwa, typ). Przykład zastosowania: lista rozwijana wyboru sądu powszechnego.

Odpowiedź

Lista wydziałów sądu powszechnego

Adres

https://www.saos.org.pl/cc/courts/CC_COURT_ID/courtDivisions/list

CC_COURT_ID - wewnętrzny identyfikator sądu powszechnego w SAOS

Opis

Pozwala na pobranie listy wydziałów sądu powszechnego z podstawowymi danymi (id, nazwa). Przykład zastosowania: lista rozwijana wyboru wydziału dla danego sądu powszechnego.

Odpowiedź

Lista izb Sądu Najwyższego

Adres

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

Opis

Pozwala na pobranie listy izb Sądu Najwyższego z podstawowymi danymi (id, nazwa). Przykład zastosowania: lista rozwijana wyboru izby Sądu Najwyższego. 

Odpowiedź

Lista wydziałów izby Sądu Najwyższego

Adres

https://www.saos.org.pl/sc/chambers/SC_CHAMBER_ID/chamberDivisions/list

SC_CHAMBER_ID - wewnętrzny identyfikator izby Sądu Najwyższego w SAOS

Opis

Pozwala na pobranie listy wydziałów izby Sądu Najwyższego z podstawowymi danymi (id, nazwa). Przykład zastosowania: lista rozwijana wyboru wydziału izby Sądu Najwyższego. 

Odpowiedź

Lista dostępnych form orzeczeń Sądu Najwyższego

Adres

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

Opis

Pozwala na pobranie listy możliwych form orzeczeń Sądu Najwyższego (id, nazwa). Przykład zastosowania: lista rozwijana/ lista checkboxów wyboru formy orzeczenia lub pobranie słownika form orzeczeń do własnej bazy.

Odpowiedź

Wyszukiwanie pozycji dziennika ustaw

Adres

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

Opis

Pozwala na wyszukiwanie pozycji dziennika ustaw spośród tych, które dostępne są w SAOS. W SAOS dostępne są jedynie te pozycje dziennika ustaw, do których odwołuje się jakieś orzeczenie.

Przykład zastosowania: pole autocompletion wybory dziennika ustaw.

Parametry

Przykład wywołania

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

Odpowiedź

Wyszukiwanie słów kluczowych orzeczeń sądów powszechnych

Adres

https://www.saos.org.pl/keywords/COMMON/KEYWORD_START

KEYWORD_START- początek słowa kluczowego; będą wyszukane tylko słowa kluczowe rozpoczynające się na podaną frazę

Opis

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

Przykład wywołania

https://www.saos.org.pl/keywords/COMMON/prawo

Odpowiedź

Generowanie wykresów

Adres

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

Opis

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

Przykład wywołania

https://www.saos.org.pl/analysis/generate?globalFilter.courtCriteria.courtType=COMMON&globalFilter.courtCriteria.ccCourtId=&globalFilter.judgmentDateRange.startMonth=1&globalFilter.judgmentDateRange.startYear=1995&globalFilter.judgmentDateRange.endMonth=6&globalFilter.judgmentDateRange.endYear=2015&seriesFilters[0].phrase=&ysettings.valueType=NUMBER

Parametry

Odpowiedź

Obiekt analysisForm

Obiekt zawiera wartości parametrów wywołania serwisu. Dla przykładowego wywołania obiekt przyjmie następującą formę:

"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"
    }
}

Obiekt charts.MAIN_CHART

Zawiera dane dla głównego wykresu (liczba orzeczeń z podziałem na przedziały czasowe)

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

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

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

Obiekt charts.AGGREGATED_MAIN_CHART

Zawiera dane wykresu podsumowującego wykres główny. Oś x określa serię wykresu głównego. Oś y jest sumą wartości wszystkich punktów danej serii wykresu głównego.

Obiekt charts.CC_COURT_CHART

Zawiera dane wykresu z podziałem na sądy powszechne.

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