Interpelacje
============

Lista interpelacji
------------------

.. http:get:: /sejm/term(int:term)/interpellations

  Zwraca listę interpelacji, które wpłynęły do Sejmu w kadencji `term`.
  Zwracana lista uwzględnia podział na strony. Domyślnie zwracane jest tylko 50 interpelacji.
  
  :param int term: kadencja Sejmu
  :query int offset: indeks od której pozycji dane będą zwracane
  :query int limit: liczba zwracanych pozycji
  :query string sort_by: pole po którym dane mają zostać posortowane
  :query string title: wyszukiwanie wg fraz w tytule, np. ``title=szpitali``
  :query string from: wyszukanie interpelacji składanych przez posła, np. ``from=Adamczyk Rafał``. Można też podać nr legitymacji, np. ``from=001``
  :query string to: wyszukanie interpelacji wysłanych do danego ministerstwa, np. ``to=minister sprawiedliwości``
  :query date since: data od której będą zwracane interpelacje (data wysłania interpelacji)
  :query date till: data do której będą zwracane interpelacje (data wysłania interpelacji)
  :query datetime modifiedSince: zwraca interpelacje, które zostały zmienione od podanej daty
  

.. topic:: Przykłady

  interpelacje zawierające w tytule słowo "szpitali", do ministra zdrowia, od posła o nr legitymacji=2, złożone od 2022-01-01 do 2022-09-01
    https://api.sejm.gov.pl/sejm/term9/interpellations?title=szpitali&from=002&to=minister%20zdrowia&since=2022-01-01&till=2022-09-01

  interpelacje do ministra zdrowia, posortowane wg daty modyfikacji (od najnowszych)
    https://api.sejm.gov.pl/sejm/term9/interpellations?to=minister%20zdrowia&sort_by=-lastModified

  interpelacje do ministra zdrowia, posortowane wg daty wysłania, zaczynając od 10 pozycji, maksymalnie 5 pozycji
    https://api.sejm.gov.pl/sejm/term9/interpellations?to=minister%20zdrowia&sort_by=sentDate&offset=10&limit=5
	
  interpelacje zmodyfikowane po podanej dacie, posortowane od najwcześniej zmienionych
    https://api.sejm.gov.pl/sejm/term9/interpellations?modifiedSince=2023-02-28T10:00&sort_by=lastModified


Zwracane dane
-------------

.. json:object:: Interpellation

  :property int term: nr kadencji
  :property int num: numer interpelacji
  :property string title: tytuł interpelacji
  :property from: lista nr legitymacji posłów składających interpelację
  :property to: lista adresatów (ministerstw)
  :property receiptDate: data otrzymania interpelacji
  :property sentDate:  data wysłania interpelacji do adresatów
  :property replies: lista odpowiedzi na interpelację
  :proptype replies: :json:object:`Reply`
  :property lastModified: data ostatniej modyfikacji
  :property links: lista adresów URL do opisu i treści interpelacji
  :proptype links: :json:object:`Link`
  
  
Links
-----

Pole ``links`` zawiera listę adresów URL do opisu lub treści interpelacji, zapytania lub odpowiedzi.

.. json:object:: Link

  :property url href: adres URL
  :property rel: typ zawartości
  
Wartości pola ``rel``:
  - web-description - adres strony z opisem interpelacji/zapytania w serwisie SIS
  - web-body - adres strony z treścią interpelacji/zapytania lub odpowiedzi w serwisie SIS
  - body - adres strony API z samą treścią w formacie HTML


Odpowiedzi
----------

.. json:object:: Reply

  :property string key: unikalny identyfikator odpowiedzi
  :property string from: stanowisko i nazwisko osoby odpowiadającej
  :property links: lista adresów URL do treści odpowiedzi (typy ``web-body`` i ``body``)
  :proptype links: :json:object:`Link`
  :property receiptDate: data otrzymania odpowiedzi
  :property boolean onlyAttachment: flaga określająca czy odpowiedź występuje tylko w postaci pojedyńczego pliku (np. pdf), bez treści w postaci HTML
  :property attachments: lista załączników
  :proptype attachments: :json:object:`Attachment`
  :property lastModified: data ostatniej modyfikacji


.. json:object:: Attachment

    :property url URL: adres załącznika do pobrania
    :property string name: nazwa pliku
    :property lastModified: data ostatniej modyfikacji	


Sortowanie
----------

Sortowanie jest możliwe przez podanie parametru ``sort_by``. Jako wartość parametru należy podać pole po którym dane mają zostać posortowane. Pole można poprzedzić znakiem ``-``, aby posortować dane malejąco.

Pola po których można sortować listę interpelacji:
  - lastModified - data ostatniej modyfikacji
  - num - numer interpelacji
  - receiptDate - data otrzymania interpelacji
  - sentDate - data wysłania interpelacji do ministerstwa