GSIP-237 Update OpenAPI (Swagger) specs

The REST — GeoServer 2.28.0 User Manual is unmaintained, outdated and inaccurate.

Please see my GSIP 237 to bring it up to date and to keep it up to date. Also ties in with GeoServer 3 REST API /v1/ endpoint. I would be interested in input on how best to annotate functions, please edit the above wiki page with suggestions (or comment here below).

Triggered by GeoServer Api

Thanks

Peter

Back at the time we switched to Spring MVC (from restlet) an attempt to use SpringFox was made, but failed. It’s been a while, but as far as I remember, the core of the issue is that we generate the XML and JSON representations through XStream rather than Jackson, and that we use plenty of custom converters, so the schema of the API only partially matches the Java Bean that SpringFox migth be using to create the OpenAPI documents.

Did anything change in this regard, in the meantime?

Cheers
Andrea