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 Datenlizenz Deutschland – Namensnennung – Version 2.0utschland 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 |