Designing REST #api with Open API Specification (OAS) v2.0 & v3.0 using #swagger
▻https://hackernoon.com/designing-rest-api-with-open-api-specification-oas-v2-0-v3-0-using-swagg
Disclaimer: I presume we all have written one or multiple API at certain point in time in our career, otherwise you would not have bumped into this article. The article does not describe what REST API is, rather you should have some basic knowledge about REST API before going through the article.Introduction:Generally when we write REST API, we focus a lot on implementation & very little time on designing the proper request / response schema, API resource models. We jot down just all necessary request & response (in most of the cases HTTP Code 200 series response) parameters in a document, get it reviewed quickly, accordingly we create some resource models & jump into implementation. This strategy works in small to mid-size companies or startup companies. But once you start (...)