API designPrinciple

Amundsen's Maxim

Remember, when designing your Web API, your data model is not your object model is not your resource model is not your message model.

A plain-language paraphrase. Original sources below.

The idea behind it

This maxim was first proposed in 2012 by Mike Amundsen. It suggests that different layers in an API should be designed independently for the greatest flexibility. Because each layer has different concerns, changes to one do not always mean changes to another layer.

Go to the source

Amundsen's Maxim - An open admonishment to all API architects, designers, & implementors
What is Amundsen's Maxim?

Also searchable by

amundsenapi design