Pagination

Une liste qui peut s’allonger revient une page à la fois :

{
  "data": {
    "items": [],
    "next_cursor": "eyJpZCI6IjAxSjhRWjRN..."
  }
}

Renvoyez next_cursor dans le paramètre de requête after pour obtenir la page suivante, et arrêtez quand il vaut null :

curl "https://app.stockshift.io/api/v1/catalog/items?after=eyJpZCI6IjAxSjhRWjRN..." \
  -H "Authorization: Bearer $STOCKSHIFT_TOKEN"

Traitez le curseur comme une valeur opaque. Ne l’analysez pas et n’en fabriquez pas vous-même.

Avec un SDK

Chaque SDK suit les curseurs pour vous :

for await (const item of stockshift.paginate("/catalog/items", { query: { search: "bolt" } })) {
  console.log(item.sku);
}

for item in stockshift.catalog.iter_items(search="bolt"):
    print(item.sku)

for item, err := range client.Catalog.ListItemsAll(ctx, nil) {
	if err != nil {
		return err
	}
	fmt.Println(item.SKU)
}

La page de chaque SDK donne les détails.