RESTful Design: Best Practices with a .NET example

Introduction This is yet another blog post about how to build a REST API, however from my perspective and focusing on using Microsoft .NET technologies. Guidelines Consistency - While it’s not essential to adhere strictly to particular standards, it’s crucial to maintain consistency in your approach. Follow the OpenAPI spec, either generate the OpenAPI spec from your API or write the spec and generate your API. Having an OpenAPI spec means a client can be generated, documentation can be generated, contract testing tooling can be bootstrapped and more....

August 14, 2023 · 5 min

Verticle Slice Architecture

Introduction Often we build abstractions into our projects around technology layers i.e. web, business, domain, data, etc. However this shouldn’t be our primary concern, it’s a secondary concern. We should focus on functional units of work, and we might choose to split these functional units of work by their respective technology layers, however not all functional units of work need to use the same underlying architecture. We want to primarily decouple features so that we’re able to scale in a way that can be supported by our organisational structure....

January 27, 2023 · 4 min