Open311 ist ein offener Standard zum Anliegenmanagement zwischen Bürger und Behörden im öffentlichen Raum. Der Begriff leitet sich von der in den USA und Kanada üblichen Sonderrufnummer 3-1-1 ab. Open311 ist nicht für Notrufe oder persönliche Anfragen – wie Adressänderungen, Leistungsanträge, Dokumentenanforderungen – konzipiert.
Open311 nutzt das standardisierte und offene Format GeoReport v2, das Schadensmeldung, Schadensart, Position und deren Bearbeitungszustand in XML oder JSON darstellt. Die meisten GeoReport V2 Server nutzen REST als Schnittstelle.
[Quelle: Wikipedia]
Get 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://www.roesrad.de/georeport/v2/services.[format] |
| Sample URL | https://www.roesrad.de/georeport/v2/services.xml |
| Formats | XML / JSON |
| HTTP Method | GET |
| Requires API Key | No |
Get Requests
| Purpose | Query the current status of multiple requests |
|---|---|
| URL | https://www.roesrad.de/georeport/v2/requests.[format] |
| Sample URL | https://www.roesrad.de/georeport/v2/requests.json?start_date=2016-07-15... |
| Formats | XML, JSON |
| HTTP Method | GET |
| Requires API Key | No |
Other parameters
| Field Name | Description | Notes & Requirements |
|---|---|---|
|
Specify the service type by calling the unique ID of the service_code. | This http://s to all service codes when not declared; can be declared multiple times, comma delimited |
|
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. |
|
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. |
|
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 |
|
Allows to search for requests for a specific jurisdiction who share the same services catalogue | e.g. bruehl.de |
Get Service Request
| Purpose | Query the current status of an individual request |
|---|---|
| URL | https://www.roesrad.de/georeport/v2/requests/#ID.[format] |
| Sample URL | https://www.roesrad.de/georeport/v2/requests/R-1.json |
| Formats | XML, JSON |
| HTTP Method | GET |
| Requires API Key | No |