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 […]
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 […]
Yesterday, I had a thought. It didn’t fit into a tweet so wrote a few paragraphs. I was very pleased with myself, finally getting round to writing again after a few months off. That was, until two different people who I respect highly, told me I was wrong. That part sucked. Who Can Do This For […]
Here’s a thought that wouldn’t fit into a tweet and will serve the purpose of breaking my blogging dry spell. With all the attention that microservices is currently receiving I regularly hear people talking about service discovery. When trying to co-ordinate multiple different services working together, it is critical to be able to dynamically configure […]
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 […]