Josh Bohde

Don't Design the API to the Client

Posted by Josh Bohde

A problem I often see with first production versions of HTTP APIs is they are tightly coupled to the client code. This is especially easy to do in web applications where both the client and server source are contained in the same repository.

A few signs in development you should watch out for:

These hint that the API may be too specialized to the client. This make other clients harder to develop, and makes changing the current client difficult. Instead, let client development push the API to develop flexibility, instead of assumptions on how it will be used.