Głosowania
==========

Lista głosowań
--------------

.. http:get:: /sejm/term(int:term)/votings/(int:sitting)

  Zwraca listę głosowań na danym posiedzeniu Sejmu.
  
  :param int term: kadencja Sejmu
  :param int sitting: nr posiedzenia Sejmu

.. topic:: Przykład

  https://api.sejm.gov.pl/sejm/term10/votings/1


Szczegóły głosowania
--------------------

.. http:get:: /sejm/term(int:term)/votings/(int:sitting)/(int:votingNum)

  Zwraca szczegóły głosowania na danym posiedzeniu Sejmu.
  
  :param int term: kadencja Sejmu
  :param int sitting: nr posiedzenia Sejmu
  :param int votingNum: nr głosowania
  

.. topic:: Przykłady

  - https://api.sejm.gov.pl/sejm/term10/votings/1/1
  - https://api.sejm.gov.pl/sejm/term10/votings/1/2 

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

.. json:object:: Voting

  :property int term: nr kadencji
  :property int sitting: nr posiedzenia Sejmu
  :property int sittingDay: nr dnia posiedzenia Sejmu
  :property int votingNumber: nr głosowania
  :property int yes: liczba głosów za
  :property int no: liczba głosów przeciw
  :property int abstain: liczba wstrzymujących się
  :property int notParticipating: liczba posłów, którzy nie wzieli udziału w głosowaniu
  :property int totalVoted: liczba oddanych głosów
  :property date: data głosowania
  :property string title: temat głosowania
  :property string description: opis głosowania
  :property string topic: krótki temat głosowania
  :property url pdfLink: link do dokumentu PDF ze szczegółami głosowania
  :property kind: typ głosowania, jeden z ELECTRONIC, TRADITIONAL, ON_LIST
  :property votingOptions: lista opcji do głosowania, jeżeli jest to głosowanie na listę
  :proptype votingOptions: :json:object:`VotingOption[]`
  :property votes: lista głosów (zwraca tylko dla szczegółów głosowania)
  :proptype votes: :json:object:`Vote[]`
  

  .. json:object:: VotingOption

  :property int optionIndex: indeks opcji na liście
  :property string option: nazwa opcji
  :property string description: opcjonalny opis opcji
  :property int votes: liczba głosów na daną opcję


  .. json:object:: Vote
  
  :property int MP: nr legitymacji posła
  :property string club: klub/koło do którego należy poseł
  :property string firstName: imię
  :property string lastName: nazwisko
  :property string vote: oddany głos: YES, NO, ABSTAIN, ABSTAIN, VOTE_VALID
  :property listVotes: lista wybranych opcji w przypadku głosowania na listę


Głosowania dla posłów
---------------------

.. http:get:: /sejm/term(int:term)/MP/(int:leg)/votings/(int:sitting)/(date)

  Zwraca wyniki głosowania danego posła w dany dzień głosowań.

  :param int term: kadencja Sejmu
  :param int leg: nr legitymacji posła
  :param int sitting: nr posiedzenia Sejmu
  :param date: data głosowania w formie yyyy-mm-dd
  
.. topic:: Przykład

  https://api.sejm.gov.pl/sejm/term10/MP/1/votings/1/2023-11-13


.. json:object:: VoteMP

  :property int votingNumber: nr głosowania
  :property date:	data i czas głosownia, np. "2023-11-13T15:17:22"
  :property string title: temat głosowania
  :property string description: opis głosowania
  :property string topic: krótki temat głosowania
  :property kind: typ głosowania, jeden z ELECTRONIC, TRADITIONAL, ON_LIST
  :property string vote: oddany głos: YES, NO, ABSTAIN, ABSTAIN, VOTE_VALID
  :property listVotes: lista głosów oddanych "tak" na listę