Skip to content

.tip

· one of the small things

Link headers carry the next page so the body stays clean

Clients shouldn't have to build the next URL themselves, so send it to them.

Link: </events?cursor=abc>; rel="next", </events?cursor=xyz>; rel="prev"

The body is just the items. A client walks the list by following rel="next" until it's gone, and that logic is the same for every list in the API.

httpapi-design