API Handyman

{"input" : "learn", "output" : "share"}

API Style Guides Fireside Chat with Ronnie Mitra (API Days London 2016)

API Days London 2016, take 2! I was very happy when Ronnie Mitra (@mitraman) from the API Academy invited me to do a fireside chat on API Style Guides at API Days London.

Read more

OpenAPI Trek (API Days London 2016)

I was thrilled to start my OpenAPI specification (fka. Swagger specification) talk series at API Days London with this first part simply titled OpenAPI Trek.

Read more

HTTP Status Trek (REST Fest 2016)

I had the luck to go back to REST Fest, this second time was as awesome as last one. Here’s the video and slides of my 5 in 5 about HTTP Status Codes.

Read more

The API Stylebook

I’m a thrilled to announce that apistylebook.com is now online.

The API Stylebook aims to help API Designers to solve API design matters and build their API design guidelines by providing quick and easy access to selected and categorized resources.

Read more on the API Stylebook blog

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