Pagination

Parcourir les longues listes par curseur.

Les listes longues (VPS, journal, opérations) sont découpées en pages. Chaque page répond :

{ "data": [ … ], "has_more": true, "next_cursor": "eyJvIjoyMH0" }

Le curseur est opaque : renvoyez-le tel quel, sans le modifier. Un curseur invalide répond 400 invalid_cursor.

Parcourir toute une liste

import os, requests

headers = {"Authorization": f"Bearer {os.environ['CORCELINK_API_KEY']}"}
url, params, events = "https://api.corcelink.fr/v1/compute/vps/vps-7c2e4a91/events", {"limit": 100}, []
while True:
    page = requests.get(url, headers=headers, params=params, timeout=30).json()
    events += page["data"]
    if not page["has_more"]:
        break
    params["cursor"] = page["next_cursor"]
print(len(events), "événements")

Les filtres (par exemple status ou region) se combinent avec la pagination : gardez les mêmes filtres d’une page à l’autre.