OpenAPI Trek Series - Part 2
OpenAPI Trek Into Fastness
By Arnaud Lauret, November 19, 2016
API Style Guides Fireside Chat with Ronnie Mitra (API Days London 2016)
By Arnaud Lauret, November 17, 2016
OpenAPI Trek Series - Part 1
By Arnaud Lauret, November 10, 2016
The API Stylebook
By Arnaud Lauret, September 10, 2016
Writing OpenAPI (Swagger) Specification Tutorial Series - Part 8
Splitting specification file
By Arnaud Lauret, August 2, 2016
With previous posts we have learned to produce an OpenAPI specification containing all OpenAPI specification subtleties. Some specification files may become quite large or may contain elements which could be reused in other APIs. Splitting a specification file will help to keep it maintainable by creating smaller files and also help to ensure consistency throughout APIs by sharing common elements.
Writing OpenAPI (Swagger) Specification Tutorial Series - Part 7
By Arnaud Lauret, June 12, 2016
Previous posts showed how to write a highly accurate description of an API interface contract with the OpenAPI specification. But an interface contract, no matter how brilliant, is nothing without some explainations. A fully documented OpenAPI specification file can provide some useful information and be used as a part of an API’s documentation.