Validateur de spécification OpenAPI / Swagger

Swagger 2.0 was the original API specification format developed by SmartBear. When the specification was donated to the OpenAPI Initiative in 2015, it was renamed to OpenAPI. Version 3.0 introduced significant improvements including better support for callbacks, links, multiple servers, and a cleaner component structure. The two formats are not directly compatible.

operationIds serve as unique identifiers for each API operation. Code generators use them to create method names in client SDKs, documentation tools use them for anchor links, and testing frameworks use them to reference specific endpoints. Duplicate operationIds cause conflicts in all of these downstream tools.

A JSON Pointer (RFC 6901) is a string syntax for identifying a specific value within a JSON document. For example, /paths/~1users/get/parameters/0 points to the first parameter of the GET /users operation. The ~1 escapes a forward slash in the path segment. Reading these pointers tells you exactly where in your spec the validation error occurs.

Both formats are fully supported and functionally equivalent. YAML is generally preferred for hand-written specs because it is more readable and supports comments. JSON is better for machine-generated specs and programmatic manipulation. Most tools accept either format, so choose whichever your team finds easier to maintain.