Open api is an exchange format, it quickly become to verbose and repetitive, it is only OK when auto generated and consumed by tooling.