Lint an API specification

Validates an API specification against style and correctness rules. Returns linting results with warnings and errors.