L’appel de toute méthode de liste qui renvoie plusieurs résultats, comme /customers, peut nécessiter une pagination : plusieurs appels pour récupérer tous les résultats. Metronome fournit deux paramètres d’URL sur tous les endpoints de liste à cette fin :
limit personnalise le nombre de résultats renvoyés par pagenext_page spécifie le curseur à utiliser comme point de départ pour récupérer le prochain ensemble de résultats
Lorsqu’une réponse renvoyée contient une valeur next_page, cela signifie qu’il existe plus d’enregistrements que ceux qui ont été renvoyés. Incluez cette valeur next_page dans une requête ultérieure pour récupérer le prochain ensemble de résultats. Pour récupérer tous les résultats, répétez ce processus jusqu’à ce que next_page soit null.
Avec la réponse ci-dessus, vous pouvez fournir le curseur next_page à la requête suivante.
BONNES PRATIQUES POUR LIMITPour effectuer un appel d’API rapide afin d’inspecter le format de la réponse, définissez limit=1. Pour charger de nombreux résultats avec le moins d’appels d’API possible, définissez limit=50. Pour des raisons de performance, limit est plafonné à 100.
