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

HTTP API

RESTful JSON: Adding Links to your APIs

There’s a new media type available, RESTful JSON, that was recently registered (Feb 1st 2018) with IANA.  It’s really the simplest possible media type to use in order to start adding links to your JSON APIs.  The new media type is application/vnd.restful+json  Adding Hyperlinks The simplicity here is that you can start using this media type with existing APIs to start adding links to your existing objects. JSON objects MAY include a url property to indicate a link to itself JSON objects MAY append _url to properties to indicate related links Example Here’s an existing payload of a e-commerce shopping cart.  It has one product… Read More »RESTful JSON: Adding Links to your APIs

Self Descriptive HTTP API in ASP.NET Core: Hypermedia Clients

This post is in my Self Descriptive HTTP API in ASP.NET Core series. It demonstrates how to design an HTTP API like a regular HTML website. This specific posts covers hypermedia clients. If you’re new to this series, here are earlier posts to get up to speed: Intro Object as Resource Hypermedia Siren HATEOAS If you have any questions, please follow me on Twitter. Hypermedia Clients My perception is that most people new to hypermedia driven APIs think that consuming hypermedia happens via a magic library. Or via some code generation that ultimately gives you a client library that understands every endpoint. I’m not… Read More »Self Descriptive HTTP API in ASP.NET Core: Hypermedia Clients

Self Descriptive HTTP API in ASP.NET Core: HATEOAS

This post is in my Self Descriptive HTTP API in ASP.NET Core series. It demonstrates how to design an HTTP API like a regular HTML website. Bringing the concepts of links and actions to your API allows your clients to consume it with ease. If you’re new to this series, here are earlier posts to get up to speed: Intro Object as Resource Hypermedia Siren If you have any questions, please follow me on Twitter. Actions In my last post I covered outputting a siren hypermedia payload from our ASP.NET Core MVC application.  Specifically I showed linking to each Todo item within… Read More »Self Descriptive HTTP API in ASP.NET Core: HATEOAS