Paginación

Una lista que puede crecer devuelve una página a la vez:

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

Envía next_cursor de vuelta como el parámetro de consulta after para obtener la página siguiente, y detente cuando sea null:

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

Trata el cursor como un valor opaco. No lo analices ni construyas uno tú mismo.

Con un SDK

Todos los SDK siguen los cursores por ti:

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 página de cada SDK tiene los detalles.