It is true three women can’t make a baby in 3 months, but it also doesn’t take 27 months for them to have 3 babies! You might be wondering what on earth I am talking about but this is something I see API developers getting confused about regularly. There is oft-repeated guidance that if an API […]
Sometimes I do my best thinking in the car and today was an excellent example of this. I had a phone call today with a the digital agency Authentic who have been hired to help you stop saying Swagger, when you mean OpenApi. I’m only partially kidding. They asked me some hard questions about why I got involved in […]
When building HTTP based applications we are limited to a small set of HTTP methods in order to achieve the goals of our application. Once our needs go beyond simple CRUD style manipulation of resource representations, we need to be a little more creative in the way we manipulate resources in order to achieve more […]
I’ve spent a large part of the last two years playing the role of a technical marketeer. Call it developer advocate, API Evangelist, or my favourite title, API Concierge, my role was to engage with developers and help them, in any way I could, to build better HTTP APIs. I have really enjoyed the experience […]
Although I know my HTTP and Web API pretty well, becoming an API Evangelist on the Azure API Management team means also needing to know the nitty gritty of the Azure API Management product too. In my learning process I have discovered a wealth of useful information, but it is scattered around a little. Some is on the Azure documentation site, some on […]
The recording for episode #3 is now available on Crowdcast and YouTube. In this episode we cover issues like API description languages, security weaknesses in HTTP APIs and the illusive HTTP status code 410 Gone. Some of the questions we attempted to answer this week include: Links from the show include: Keep your eyes on our twitter accounts @darrel_miller and @gblock for the […]
As a software developer today it is pretty difficult to avoid working with HTTP in some capacity. There also seems to be a growing desire among developers to get a deeper understanding of the protocol. Recently Glenn Block and I decided it might be interesting to do a online Q&A about HTTP and try and answer developer […]
The site apisjson.org defines a specification for creating a document that declares the existence of an API on the web. This document provides some identification information about the API and links to documentation and to the actual API root URL. It also supports pointing to other resources like API design metadata documents and contact information for maintainers […]
I recently needed to create a new Web API project for some content I’m working on for a talk. I decided I might as well use the ASP.NET Web API Template to get started. The resulting project looked like this: 75 class files, 23 Razor templates, 34 unique Nuget packages, and 28 Javascript files before I wrote […]