Views
API
Collaboration for an Open311 Standard
Contents |
Open311 APIs
Inquiry/Information beta
Spec: Inquiry v1
The Inquiry/Information API is meant to be accessed to retrieve non-GeoReport-related content. This can be used for information which is typically provided to callers of a 311 system as an answer to their question. It supports three fundamental capabilities: services, facilities, and a "311 today" (RSS) feed.
Spec: Inquiry v2 Draft
Version 2 is meant to provide a more generic version of the Inquiry/Information API with extended features.
GeoReport v2
Spec: GeoReport v2
Service Discovery
GeoReport v2 and following versions are meant to be accessed via the Service Discovery mechanism to identify the status and version number for available endpoints in each jurisdiction. The service discovery mechanism is a requirement of the specification, but is meant to be independent and persistant beyond the GeoReport v2 version of the spec.
Please view the Service Discovery specification.
Servers
Servers receive and manage service requests on behalf of a jurisdiction. A comprehensive list is being maintained on the GeoReport v2 Servers page
Open source developer resources for the GeoReport v2 specification.
Server Software
Server applications provide an API endpoint and can receive and manage reports.
- uReport Open311 Server. PHP-based Open311 Server & CRM by Bloomington
- GeoReport v2 Server - Python-based middleware/server by Miami-Dade County
- GeoReport v2 Server by Diptanu - Python-based CRM server in early stages of development
- Mark-a-Spot Drupal Distribution. There's also Integration for the older standalone Mark-a-Spot CakePHP code.
- Open311 on Joget. See Blog post. (in development).
- (Deprecated) Open311 API in PHP - raw API with no UI - refer to fms-endpoint and Ushahidi plugin below which have improved this code
- Open311 Plugin for Ushahidi (in development. More background on the Ushahidi wiki)
- FMS-Endpoint Open311 API for FixMyStreet - "fms-endpoint" using Codeigniter PHP - by MySociety (Doesn't require FixMyStreet. Based on two codebases listed above)
- FixMyStreet integration. See FixMyStreet.com/open311 and example of support within a city: Southampton UK
- Shareabouts has planned support in the future.
- I think there may also be some ongoing work for Kajoo integration
Client Applications
Software that interacts with an Open311 server by connecting to an API.
- GeoReporter Open311 iPhone app
- GeoReporter download from the Apple Store
- Open311 Proxy - a PHP/HTML/javascript client that doesn't expose API keys
- Open311 Facebook app
- Open311 Dashboard See the Blog post (in development)
- Open311 Plugin for Ushahidi - can reroute issues from Ushahidi to an external Open311 endpoint.
- OpenBlock is not an Open311 client per se, but can consume and display Open311 reports on a map; see Boston demo
Client Libraries (API Wrappers)
Client libraries make it easier to build client applications that work with the spec.
- PHP by Ronaldo Barbachano at Code for America
- Python by Zach Williams at Code for America
- Ruby Gem by Code for America labs et al (see it on GitHub)
- Node.js by Mark Headd and Ben Sheldon
- C# by Mark Headd
- Clojure by Ryan Briones
Test Suites
Test suites are used to verify that a server is compliant with the specification.
- https://github.com/seeclickfix/open311-validator/ (ruby based, initial release Nov 2011)
- http://github.com/open311/open311-validator-py (python based, not up to date)
- GeoReporter Client can be used to test GeoReport v2 endpoints.
- https://github.com/ryanbriones/open311-api-tests
Products & Services
See also GeoReport v2 Support for products and services.
GeoReport v1
Spec: GeoReport v1
Servers
Servers receive and manage reports on behalf of a jurisdiction.
Note that the URLs require a method and jurisdiction_id at the end, the root URL is not intended to be accessed directly.
| Name | Status | API Key | city_id | Dev API | Production API |
|---|---|---|---|---|---|
| San Francisco | Production Ready | Request Key | sfgov.org | Dev URL | Production URL |
| Miami-Dade County | Development Ready | Request Key | miamidade.gov | Beta URL | - |
Clients (can send and view reports)
- SeeClickFix
- CitySourced
- Facebook App (for San Francisco's Open311 API)
Client Libraries (API Wrappers)
- PHP Library by Mark Head
