← Back to all sparks
R

r311

DEVOPS
Velocity0.0

R interface to the open311 standard for civic service requests

r311 curates a catalogue of Open311 endpoints and now marks the dead ones explicitly.

open311civic dataapi clientendpoint curationr package
Current state
r311 wraps Open311 civic-issue APIs behind one R interface, with a bundled list of municipal endpoints. Recent releases are dominated by keeping that list current — Helsinki added in 0.4.4, Espoo and Oulu in 0.4.3, with Ottawa, Siegburg, Northfield and Annaberg-Buchholz deprecated. Version 0.4.3 added the machinery to record that decay: questioned and deprecated keys that make o311_api() warn or abort.
Where it's heading
The package's real work is curation, and it has started treating endpoint rot as a first-class state rather than letting requests fail silently. Error handling and condition objects were hardened in the same release, which fits a client whose dominant failure mode is a city's server going away. Releases are small and roughly annual.
Prediction
Expect the next release to be another catalogue pass — a city or two added, more moved to questioned or deprecated — rather than new API surface.

Recent moves

  1. 6mo ago

    Adds Helsinki to the endpoint catalogue

    A single-city addition to the bundled API list. Routine curation, which is this package's normal cadence rather than a change in capability.

    View source ↗
  2. 1y ago

    Deprecation system for dead Open311 endpoints

    The release that made endpoint decay explicit: questioned and deprecated flags drive warnings and aborts, alongside firmer error conditions and set-equality request comparison. It turns the silent-failure mode of a stale catalogue into something the caller sees.

    View source ↗