This document is related to the document MFF-BAS API Design Guidelines. Although the latter is based on the API strategy for the Dutch Government, it did not provide a URI strategy. Therefore, the Working Group API Strategy made the decision to establish agreements regarding the use and application of URIs themselves. Written by several colleagues […]
URI Strategy Dutch Energy Sector Read More »
Being a huge fan of the work of Professor Dr. Olaf Zimmermann, I immediately bought “Patterns for API Design: Simplifying Integration with Loosely Coupled Message Exchanges” once it was available in November 2022. Co-authors are: Mirko Stocker, Daniel Luebke, Uwe Zdun and Cesare Pautasso. It’s published in the signature series of Vaughn Vernon. Excellent book!
Patterns for API Design: Adoption Story Part 1 Read More »
The objective of this document is to define a minimal set of HTTP status codes that should be supported and specified by an API designed in the Dutch Energy sector. In this document, in addition to NL government APIs and GitHub discussions, international best practices have been explored, and there has been a thorough examination
HTTP status codes: the minimal set Read More »
In this document, RFC 7807 Problem Details for HTTP APIs is analyzed and proposed as a guideline for the Dutch Energy sector. In the meantime, this RFC confirmed with a new official proposition: the RFC 9457. The document is written in Dutch and details the usage of RFC 7807 (visible or downloadable below):
RFC 7807: Problem Details for HTTP APIs Read More »
Design strategy for the implementation of HAL in RESTful APIs. Co-authored with esteemed colleague Wouter Meijers. This document contains a proposal for the adoption of Hypertext Application Language as a convention for defining hypermedia APIs at Enexis. Document is written in Dutch. Visible or downloable via link below:
HAL design strategy proposal Read More »
