A standardized error format for HTTP responses

HTTP uses status codes to indicate the result of the servers attempt to satisfy the request. In case the server…

Read More »

HTTP – Content negotiation

With HTTP, resources are identified using URIs. And a uniquely identified resource might support multiple resource representations. A representation is…

Read More »

Avoid leaking domain logic

Many software architectures try to separate domain logic from other parts of the application. To follow this practice we always…

Read More »

From layers to onions and hexagons

In this post we will explore the transition from a classic layered software architecture to a hexagonal architecture. The hexagonal…

Read More »

File down – and uploads in RESTful web services

Usually we use standard data exchange formats like JSON or XML with REST web services. However, many REST services have…

Read More »

Kotlin: Type conversion with adapters

In this post we will learn how we can use Kotlin extension functions to provide a simple and elegant type…

Read More »

Making POST and PATCH requests idempotent

In an earlier post about idempotency and safety of HTTP methods we learned that idempotency is a positive API feature.…

Read More »

Providing useful API error messages with Spring Boot

For API users it is quite important an API provides useful error messages. Otherwise, it can be hard to figure…

Read More »

Supporting bulk operations in REST APIs

Bulk (or batch) operations are used to perform an action on more than one resource in single request. This can…

Read More »