What is OpenAPI and API documentation in Web API?

OpenAPI describes endpoints, schemas, parameters, security, and responses in a machine-readable contract. In practice, the value of this concept comes from understanding where it belongs in the architecture, what problem it solves, and what constraints or tradeoffs it introduces.