Posts

The API Handyman writes as time permits

People First: A not so gonzo API Strat Boston 2016 coverage

The last API Strat 2016 day, after the last talk, a man living in kentucky asked me something like What is the one thing you will remember about this conference?. I answered something like People First.

People First. This is definitely what sticks in my mind after this conference.

Read more

Writing OpenAPI (Swagger) Specification Tutorial - Part 8 - Splitting specification file

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.

Read more

Writing OpenAPI (Swagger) Specification Tutorial - Part 7 - Documentation

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.

Read more

Writing OpenAPI (Swagger) Specification Tutorial - Part 6 - Defining Security

After mastering input and output modeling like a Jedi, let’s see how we can describe API’s security with the OpenAPI specification’s.

Read more

Writing OpenAPI (Swagger) Specification Tutorial - Part 5 - Advanced Input And Output Modeling

After learning how to create an accurate data model, we continue to delve into the OpenAPI specification’s and discover how to describe tailor made API’s inputs and outputs.

Read more