Skip to main content
PProfileMatch
← Path

REST API Development · REST API Pagination, Filtering, Sorting and Versioning Explained

0 XP
  1. 1 current stop: learning
  2. 2 upcoming
  3. 3 upcoming
  4. 4 upcoming
  5. 5 upcoming

Finish after stop 5

Stop 1 of 5 · Bookshop warehouse: new shelf plan

Trick to keep in mind+3 XP

Adding optional is free; renaming, reshaping or newly requiring costs a new version.

A change is breaking if some existing client that worked yesterday could fail today. Clients that ignore unknown fields shrug off an extra optional field. Renaming or reshaping a field, or demanding a parameter that used to be optional, can break callers that did nothing wrong. Only those need a new version.

Read it once, then a question tests whether the trick stuck.