json-schema icon indicating copy to clipboard operation
json-schema copied to clipboard

Published 20 hours ago • verified publisher icon opis

[Question]: Is using with swagger-php possible

Open nikoladsp opened this issue 3 years ago • 1 comments

Hi, I would like to use JsonSchema in my PHP project, but also I am interested if it can (an how) be used with swagger-php to document API.

Thank you kindly

nikoladsp avatar Jul 08 '21 13:07 nikoladsp

OpenAPI and JSON Schema are similar but different. In OpenAPI v3.1.0 the schema keyword is now powered by a OpenAPI-flavoured vocabulary of JSON Schema which is compatible, but in older versions they are different.

https://apisyouwonthate.com/blog/openapi-v3-1-and-json-schema

So you probably don't want anything with "Swagger" in the name, as thats usually OpenAPI v2.0.

Pick any modern tooling from https://openapi.tools.

philsturgeon avatar Apr 08 '22 14:04 philsturgeon