Skip to content

Sponsor: Do you build complex software systems? See how NServiceBus makes it easier to design, build, and manage software systems that use message queues to achieve loose coupling. Get started for free.

Learn more about Software Architecture & Design.
Join thousands of developers getting weekly updates to increase your understanding of software architecture and design concepts.


Follow @CodeOpinion

Self Descriptive HTTP API in ASP.NET Core: Object as Resource

In my opening post I went over some of the issues I encountered when initially developing an HTTP API.  In this post I’m going to cover some of those pain points and what I think the solution was. Objects The first pain point revolves around the idea of your HTTP API returning objects.  Meaning you serialize an object to JSON and return to the client. This seems pretty typical.   Almost every example you find in regards to Web API describes this behavior. Here’s an example of what this looks like: View the code on Gist. We’re doing nothing more than… Read More »Self Descriptive HTTP API in ASP.NET Core: Object as Resource

Building a Self Descriptive HTTP API in ASP.NET Core

We have all been doing “web services” forever.  My first introduction was in the late 90’s with XML-RPC and WDDX.  Followed up soon after with SOAP.  Good times.  Oh and remember WS-*.  Don’t remind me. Why? Over the last couple years, I’ve really taken an interest in HTTP APIs. I’ve been meaning to post about my experiences developing an HTTP APIs.  It’s been an interesting last couple of years and I think there is quiet a bit to share. Issues I can only speak from my experiences and give some of the context about my situations.  Hopefully you can relate and… Read More »Building a Self Descriptive HTTP API in ASP.NET Core

Paging Azure Cosmos DB Query Results from .NET

I received a comment on my Azure Cosmos DB Transactions from .NET post from Onur: The thing I don’t like about Azure Cosmos DB is that it doesn’t support aggregations nor paging. This was actually some pretty good timing of this comment as I just ran into a situation of a side project that required to page through  a result set. Skip & Take It does not appear that Azure Cosmos DB supports (yet) SKIP and TAKE, which you would expect to use in order to do paging.  Because of this, you can’t implement all the same functionality you might expect. But there… Read More »Paging Azure Cosmos DB Query Results from .NET