July 2017
Beginner to intermediate
340 pages
7h 43m
English
The Open API 2.0 specification, also known as Swagger (https://www.openapis.org/) is a simple description language that comes as a JSON or YAML file, that lists all your HTTP API endpoints, how they are used, and the structure of the data that comes in and out. It makes the assumption that your service sends and receives JSON documents.
Swagger has the same goal that WSDL (https://en.wikipedia.org/wiki/Web_Services_Description_Language) had back in the XML web services era, but it's much lighter and straight to the point.
The following example is a minimal Open API description file which defines one single /apis/users_ids endpoint and supports the GET method to retrieve the list of user IDs:
swagger: "2.0" info: title: ...
Read now
Unlock full access