search

mysociety / fixmystreet

This is mySociety's popular map-based reporting platform: easy to install in new countries and regions
http://fixmystreet.org/
Other
500 stars 232 forks source link

Publish OpenAPI schema for our Open311 extensions #5016

Open davea opened 2 weeks ago

davea commented 2 weeks ago

We publish a wiki page outlining our extensions to the Open311 spec: https://github.com/mysociety/fixmystreet/wiki/Open311-FMS---Complete-Spec

It might be nice to capture those in an OpenAPI schema - perhaps building on top of https://github.com/open311/schema-validation/blob/master/schema/georeport-v2/swagger.json

davea commented 1 week ago

Maybe 3-4 hours for someone to get a handle on the OpenAPI spec and include our additions - it's just a YAML/JSON doc.

If we wanted to be extra helpful I suppose setting up an interactive hosted version of the spec using Swagger/ReDoc might be worthwhile, but that becomes a bigger task. Maybe another hour to investigate options and decide what to do.