Rethinking REST API Design

This article is the first in a series on REST API design, examining resource-oriented APIs, hypermedia, and the distinction between REST and conventional HTTP APIs. Data Access with Spring Data Rethinking REST API Design Reducing REST Client-Server Coupling Designing Idempotent REST APIs Most APIs described as RESTful expose resources through HTTP, use familiar methods such as GET, POST, PUT, and DELETE, and return JSON representations. OpenAPI specifications document the available operations, while generated clients make them straightforward to invoke. ...

November 16, 2026 · 8 min · Kai Niemi

Reducing REST Client-Server Coupling

This article is part of a series on REST API design, examining how runtime-discovered interactions reduce client-server coupling and accommodate evolving workflows. Data Access with Spring Data Rethinking REST API Design Reducing REST Client-Server Coupling Designing Idempotent REST APIs Suppose a client retrieves an order: GET http://localhost:8090/api/orders/8e2f3a91-6d47-4c8b-9e13-2a7b5c0d4f62 { "status": "placed", "totalPrice": 149.00 } We know the order’s state, but can we cancel it or pay for it? Where are its items, and what request performs each operation? ...

November 18, 2026 · 10 min · Kai Niemi

Designing Idempotent REST APIs

How do you safely retry a POST request when the outcome is unknown? Compare stateless preconditions and idempotency keys through funds transfers and order creation.

October 19, 2022 · 19 min · Kai Niemi