Pagination des listes de résultats

Il est difficile d’anticiper avec exactitude l’évolution de la quantité de données qui sera retournée lors des différentes requêtes. Nous paginons donc nos ressources.
De plus, la pagination étant une information importante, elle est positionnée dans la requête.
(ex : page=1&perPage=20)
Le code retour HTTP correspondant au retour d’une requête paginée est 200 Ok.
Dans le cas où la pagination demandée ne rentre pas dans les valeurs tolérées par l’API, la réponse HTTP sera un code erreur 400, avec une description explicite de l’erreur dans le body.
Exploiter la pagination

Dans la réponse à votre requête, vous allez trouver un _linksvous permettant de parcourir la pagination.
Ce link header contient un ou plusieurs liens hypermedia, les valeurs possibles étant :
next: le lien vers la page présentant les résultats suivants
last: le lien vers la dernière page de résultats
first: le lien vers la 1ere page de résultats
prev: le lien vers la page présentant les résultats précédents