"Even though it's tempting to create your own pagination scheme by "building"
URLs, you should only use the information given by the API. This means, you
cannot assume that the 3rd page can be found at /collection/3. If you do,
your client will break as soon as the API changes its pagination behaviour."
Is that a legitimate caveat?
Are there clients that don't break when you change the API the client works with? Pretty smart clients.
Are there clients that don't break when you change the API the client works with? Pretty smart clients.