Hintergrundbild mit Domtürmen
Markensymbol Köln


Open311

Open311 Logo

Die Stadt Köln stellt anonymisiert alle Informationen zu Anliegen und Kategorien, die über diese Plattform eingehen und dargestellt werden, als Open Government Data unter der Creative Commons Namensnennung 3.0 Deutschland Lizenz zur Verfügung.

Hierbei nutzen wir den internationalen Standard Open311 und stellen ein so genanntes Georeport v2 API zur Verfügung. Über diese Schnittstelle können unsere Anliegen- und Dienstleistungskategorien (Services) und die eingebrachten Anliegen (Requests) maschinell ausgewertet werden.

In zukünftigen Versionen öffnen wir die Schnittstelle auch, um Beiträge in diese Plattform einzustellen [via Method POST].

Die folgende Spezifikation stammt in großen Teilen von Open311.org, angepasst auf die lokale Bedingungen der Stadt Köln.

Services

Purpose Provide a list of acceptable 311 service request types and their associated service codes. These request types can be unique to the city/jurisdiction.
URL https://sags-uns.stadt-koeln.de/georeport/v2/services.[format]
Sample URL https://sags-uns.stadt-koeln.de/georeport/v2/services.xml
Formats XML / JSON
HTTP Method GET
Requires API Key No

Requests

Purpose Query the current status of multiple requests
URL https://sags-uns.stadt-koeln.de/georeport/v2/requests.[format]
Sample URL https://sags-uns.stadt-koeln.de/georeport/v2/requests.json?start_date=2014-1-22...
Formats XML, JSON
HTTP Method GET
Requires API Key No

Optionale Parameter

Field Name Description Notes & Requirements

service_code

Specify the service type by calling the unique ID of the service_code. This defaults to all service codes when not declared; can be declared multiple times, comma delimited

start_date

Earliest datetime to include in search. When provided with end_date, allows one to search for requests which have a requested_datetime that matches a given range, but may not span more than 90 days. When not specified, the range defaults to most recent 90 days. Must use w3 format, eg 2010-01-01T00:00:00Z.

end_date

Latest datetime to include in search. When provided with start_date, allows one to search for requests which have a requested_datetime that matches a given range, but may not span more than 90 days. When not specified, the range defaults to most recent 90 days. Must use w3 format, eg 2010-01-01T00:00:00Z.

status

Allows one to search for requests which have a specific status. This defaults to all statuses; can be declared multiple times, comma delimited; Options: open , closed
page One page shows 50 requests 0-n

Single Request

Purpose Query the current status of an individual request
URL https://sags-uns.stadt-koeln.de/georeport/v2/requests/#ID.[format]
Sample URL https://sags-uns.stadt-koeln.de/georeport/v2/requests/1d8d-0.json
Formats XML, JSON
HTTP Method GET
Requires API Key No