Pagination

Pagination par curseur : limit, next_cursor et un ordre stable.

GET /v1/properties renvoie une page à la fois :

{
  "data": [ /* up to `limit` properties */ ],
  "page": { "next_cursor": "pKZAA9cXZioUAmmXQVzN4RBwg8cC3KXflLg_..." }
}

​

Paramètres

Paramètre	Valeur par défaut	Signification
limit	25	Nombre d’éléments par page, de 1 à 100. Toute autre valeur reçoit 400 invalid_limit.
cursor	aucune	Le page.next_cursor de la page précédente. Omettez-le pour la première page.

​

Parcourir une liste

1. Demandez la première page sans cursor.
2. Si page.next_cursor est une chaîne, demandez la page suivante en donnant à cursor cette valeur, exactement telle que reçue (encodez-la pour l’URL).
3. Arrêtez-vous lorsque page.next_cursor vaut null : c’était la dernière page.

L’ordre est stable : parcourir toutes les pages renvoie donc chaque élément exactement une fois, sans jamais en omettre. Un guide montre une boucle complète.

​

À propos des curseurs

• Un curseur est opaque : son contenu n’a aucun sens pour vous, et son format peut changer à tout moment.
• Un curseur ne fonctionne qu’avec l’identifiant PMS et l’environnement qui l’ont reçu. Envoyé avec une autre clé, ou modifié de quelque façon que ce soit, il reçoit 400 invalid_cursor.
• Ne stockez pas les curseurs pour plus tard, et n’en fabriquez pas à la main. Pour recommencer, redemandez la première page.