This was taken from the Notes from Cities portion of the Open311 DevCamp Etherpad

General Description

311 twitter integration, exciting about participating in Open311 api, been considering for a while. Agrees with not just looking at request, but also disseminating information. Happy to focus just on requests for now, but then getting to how to answer questsion. Draft api is modeled after DC api. Fast tracking this, next few months . Using Lagan system, the vision is to route that to departments that do the work. Have a middleware system, using Oracle, thinking of changing that model, so 311 is a central hub, so other depts poll system. rather than pushing data out, just wnt to make sure that information will flow out. Very optimistic

Information on San Francisco's Open311 implementation

Interested in our Open311 Efforts

We’d like to invite anyone interested in moving the Open311 API forward to this public meeting. So we have an idea of your areas of interest and some background we ask that you fill out a simple form.

Here are the details: When: Dec 3rd, 5:30PM PST Where: 641.715.3625 Pin: 813951#

Agenda: 1. Present to the public our draft design spec 2. Identify gaps in design 3. Brainstorm

Proposed Architecture

SF Open 311 API

Description

Open311 will make public APIs for developers to build applications to report issues such as graffiti, potholes, and street cleaning directly to city departments.

Service Lifecycle

The following describes the user experience for submitting a 311 service request:

Service Request >> Select Location >> Service Details>> Citizen Information (optional): >> Service Request # and Service Level Agreement >> Status Update

Authentication

Purpose: authenticate credentials
Method name: token
URL:
Formats: xml
HTTP Method: GET
Requires Authentication: false
Arguments:
• username
• password

Response:
• token



Select Service

Purpose: provide a list of acceptable 311 services and associated service code
Method name: service_list
URL:
Formats: xml
HTTP Method: GET
Requires Authentication: false
Arguments: city_id
Response:

list with the following:
• service_name
• service_code
• service_description

Create Request

Purpose: Create services
Method name: services
URL:
Formats: xml
HTTP Method: POST
Requires Authentication: true
Arguments:
• token
• city_id
• service_code (obtained from method service_list)
• lat (WGS84)
• lon (WGS84)
• address_string (text description of location)
• customer_email (optional)
• device_id (optional)
• account_id (optional)
• first_name (optional)
• last_name (optional)
• phone_number (optional)
• description (free form limited to 4,000 characters) (optional)
• media_url (location of media(optional)

Response:

• service_request_id
• service_level_agreement (may not be returned)
• account_id (may not be returned)
• error codes

Status Update

Purpose: provide a status update for service request
Method name: status_update
URL:
Formats: xml
HTTP Method: GET
Requires Authentication: true
Arguments:
• token
• city_id
• service_request_id

Response:

• service_request_id
• status
• status_notes (may not be returned)
• service_name