I'll be honest I've never really considered the various drawbacks and benefits against other solutions. It's just something I occasionally run into in a legacy context where I need to integrate to get unblocked.

I think not having used it to any real extent I've not run into the parts people hate. I just get an automatically generated client library that can be treated like normal method calls, more or less.

But I've also not had the opportunity to work with OpenAPI stuff so I'm not sure what the current state of the art there looks like