It is astonishing that #OpenAPI is the standard way to define/document REST-like APIs. It is not approachable writing by hand, the available generators are shitty and even the way things like records via eg query-parameters are serialisend according to the spec are questional