spec: add missing spec for new pagination APIs

This also adds a convenience .each method on Resources objects
to transparently go through all pages.

Signed-off-by: Pierre-Alexandre Meyer <pierre@mouraf.org>