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 […]
In Phil Sturgeon’s article Understanding REST and RPC for HTTP APIs, he makes the assertion that the following URL is not technically RESTful.POST /trips/123/start I have made a habit of countering these assertions of “non-restfulness” with the following question: Can you point to the REST constraint that is violated and the negative system effects due […]
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 […]
In my experience, once a SOAP API gets into production and is working, nobody wants to touch it. They can be very finicky beasts. Sometimes the most innocuous update can stop a client application in its tracks. Exposing a SOAP API to external customers just raises the risk level. One approach I frequently see is […]
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 […]
After an interesting summer of working on OSS projects, doing a keynote in Australia at DDDMelbourne, and getting ever closer to finishing that Pluralsight course, I now have a new role to sink my teeth into I have joined Microsoft as an API Evangelist. That means if you are building HTTP APIs, my role is to try and help. Whether you are […]
I’ve been reading IETF specifications for a number of years now and I find them fairly pleasant to read. But I remember when I started there were a whole bunch of huh!? moments. Since then I have learned many of the conventions and developed a few tricks that make the process easier. I was just […]