Politnetz API

Um die Politnetz API nutzen zu können brauchst du einen Access Token. Wir senden dir gerne auf Anfrage einen per Mail zu (app at politnetz.ch).

Der Token muss bei jeder Anfrage mitgegeben werden (Der Token in den Beispielen funktioniert übrigens nicht).

Antwort-Formate

Wir unterstützen folgende Formate:

json (z.B. /parties... - default)
jsonp (z.B. /parties?callback=... - callback Parameter hinzufügen)
xml (z.B. /parties.xml...)
html (z.B. /parties.html...)

Funktionen

Politiker-Profil mit Politnetz-Id

Politiker Profil-Informationen mit einer Politnetz User-Id abrufen.

[GET] http://api.politnetz.ch/users/24980?token=07ab18667d9a

Politnetz-Id anhand einer Smartvote-Id

Politiker Profil-Informationen mit einer Smartvote User-Id abrufen.

[GET] http://api.politnetz.ch/users/id?smartvote_id=&token=07ab18667d9a

Politnetz-Politiker suchen

Suche von Politnetz-Politikern nach Name. Die query (param: q) kann aus einem oder mehreren Wörter wie Vorname, Nachname oder Doppelnahmen zusammengesetzt sein. Achtung: Es gibt einzelne Fälle, in denen bei uns Vor- und Nachname vertauscht sind. Die Resultate können optional nach Wahl und Kanton eingeschränkt werden.

[GET] http://api.politnetz.ch/users/search?q=amstutz&token=07ab18667d9a
[GET] http://api.politnetz.ch/users/search?canton=BE&election_id=84&q=amstutz&token=07ab18667d9a

Politnetz-Politiker Nach Kanton oder Partei

Auflisten von Politnetz-Politikern nach Kanton, Partei oder beidem.

[GET] http://api.politnetz.ch/users/list?canton=AG&token=07ab18667d9a
[GET] http://api.politnetz.ch/users/list?party_id=1&token=07ab18667d9a

Alle Parteien

Auflistung aller Parteien, die auf Politnetz vertreten sind.

[GET] http://api.politnetz.ch/parties?token=07ab18667d9a

Kommende Wahlen

Auflistung der anstehenden Wahlen.

[GET] http://api.politnetz.ch/elections/upcoming?token=07ab18667d9a

Statistiken

Anzahl Unterstützer nach Kanton und Partei.

[GET] http://api.politnetz.ch/users/supporter_stats?token=07ab18667d9a

Status-Codes

  • 200 - OK
  • 400 - Bad Request
  • 401 - Unauthorized
  • 404 - Not Found
  • 500 - Server Error

Mit dem Attribut suppress_response_codes können die Status Codes unterdrückt werden und die Antwort liefert immer einen 200er Status zurück (2xx - Success). Dies ist vor allem für JSONP Anfragen gedacht, da sich diese anders verhalten, als z.B eine normale JSON Anfrage.

[GET] http://api.politnetz.ch/users/:politnetz_id?suppress_response_codes=true&token=07ab18667d9a