http

REST vs RPC

Verbs are just not that evil

Fighting Wizards

Read more...

The Majesty of Trees

Grow your APIs the natural way

Oak Tree Back at the dawn of the web, the URL was created as a way of identifying and locating resources. A key characteristic of URLs on the web was the notion of a hierarchy, or tree, of resources defined by the path of the URL.

Read more...

Anatomy of HTTP API design

Divide and conquer by breaking down the elements of API design.

Skeleton So many of the things that I need to do right now involve taking API design and slicing it into small pieces that can be easily communicated and acted upon. We are working to update our Microsoft Graph API design guidelines and publish them. We are working implementing our SDK generator (Kiota) and we need samples for testing. In the OpenAPI Initiative, we are always looking for more examples of how to use OpenAPI to describe APIs. But where do you start. There is so much to cover and breaking it down into pieces seems like a good first step.

Read more...

Optimizing for the Speed of Light

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!

Read more...

HTTP Pattern Index2

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 complex goals.

Read more...

HTTP Pattern Index

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 complex goals.

Read more...

HTTP Pattern: Factory

A factory resource is one that is used to create another resource.

Read more...

HTTP Pattern: Window

A resource that provides access to a subset of a larger set of information through the use of parameters that filter, project and zoom information from the complete set.

Read more...

HTTP Pattern: Bouncer

A resource designed to accept a request body containing complex query parameters and redirect to a new location to enable the results of complex and expensive queries to be cached.

Read more...

HTTP Pattern: Whack-a-mole

A type of resource that when deleted, re-appears as a different resource.

Read more...