I've found OpenAPI to be fine to work with until you start trying to do really silly things with query parameters or multipart bodies, etc. I can understand wh

I've found OpenAPI to be fine to work with until you start trying to do really silly things with query parameters or multipart bodies, etc. I can understand why OpenAPI has those issues though - it is because OpenAPI is aiming to DOCUMENT APIs rather than SPECIFY them. That is a hard task given how wide a set of things you can do with HTTP. So be charitable when comparing OpenAPI to XYZ API specification tool.