API

Calls

Das API ist unter

https://stimmlos.org/api/

gehostet. Die Endpunkte sind

https://stimmlos.org/api/stimmlos/

https://stimmlos.org/api/elections/
https://stimmlos.org/api/electiontypes/
https://stimmlos.org/api/electionlocations/
https://stimmlos.org/api/parties/
https://stimmlos.org/api/votes/
https://stimmlos.org/api/votetypes/
https://stimmlos.org/api/infos/
https://stimmlos.org/api/infotypes/

Jedes Datenbankfeld ist sowohl als Callparameter als auch als Rückgabewert möglich. Jeder Callparameter kann durch Anfügen von '[]' mehrfach ausgeführt werden und hat dann die Wirkung einer Disjunktion, z.B.

curl "https://stimmlos.org/api/elections/?id[]=1&id[]=3" oder
curl -G -d id[]=1 -d id[]=3 https://stimmlos.org/api/elections/

gibt Daten zu den Wahlen mit den IDs 1 und 3 zurück. Der Aufruf von Endpunkten ohne Parameter gibt alle Daten des Endpunkts zurück. Die Rückgabewerte sind JSON Strings.

Endpunkt stimmlos

Dieser Endpunkt gibt die Anzahl und den Anteil unrepräsentierter Wählerstimmen zurück. Ohne Angabe einer Sperrklausel wird die der Wahl verwendet. Bei Angabe einer fiktiven Sperrklausel wird diese verwendet. Der Endpunkt verhält sich etwas anders als die anderen Endpunkte: Es gibt zwei Callparameter, die Antwort enthält Parameter, die nicht im Call verwendet werden können.

Call	Kommentar
electionid	Numerische ID der Wahl
restrictive_clause	fiktive Sperrklausel, kann nur einmal angegeben werden

Endpunkt elections

Feld	Kommentar
id	Numerische ID
name	ausführlicher Name
slug	abgekürzter Name
type	numerischer Typ der Wahl, definiert in electiontypes
location	Nummer des Gebiets der Wahl, definiert in electionlocations
date	Datum der Wahl, Format 'YYYY-MM-DD'
seats	Gesamtzahl der Sitze
restrictive_clause	Sperrklausel, meist 0.050
gov	JSON Array der Regierungsparteien (numerisch)
turnout	Wahlbeteiligung
comment	Kommentar

Endpunkt parties

Feld	Kommentar
id	Numerische ID
name	ausführlicher Name
slug	abgekürzter Name
color	RGB-Code für die Darstellung in Diagrammen
direction	Subjektive Rechts-Links-Einordnung für die Position in Halbkreisdiagrammen

Endpunkt votes

Feld	Kommentar
id	Numerische ID
electionid	ID der Wahl
partyid	ID der Partei
votetypeid	ID des Stimmentyps, bis jetzt immer 2
votes	Anzahl der Stimmen

Endpunkt infos

Feld	Kommentar
id	Numerische ID
slug	Unterüberschrift
type	numerischer Typ der Info, definiert in infotypes
headline	Überschrift
content	HTML-Artikel

Endpunkte electiontypes, electionlocations, votetypes, infotypes

Feld	Kommentar
id	Numerische ID
name	ausführlicher Name