Grokking Modern API Design Interview
Vote

0% completed

​

Versioning and Backward Compatibility

An interviewer asks:

"How would you version this API?"

A path such as /v1 is only one part of the answer. First decide whether the change needs a new version.

The first question is:

Does the proposed change break existing callers?

A new major version is useful when a change breaks the existing contract. An internal implementation change does not need a new public version if callers observe the same documented behavior.

1. Compatible and Breaking Changes

Adding risk_level to a payment response is compatible when old callers ignore it

.....

.....

.....

Like the course? Get enrolled and start learning!

Reading Progress

0%

Vote for new content