Leitfaden

Paginierung

List-Endpunkte blättern mit einem opaken Cursor. Offsets rechnest du nie aus, du folgst einfach nextCursor, bis er null ist. Cursor bleiben auch bei gleichzeitigen Schreibvorgängen stabil, du überspringst also keine Zeile und liest keine doppelt.

Die Listen-Antwort

Eine List-Antwort verpackt ihre Zeilen in items und liefert einen nextCursor zurück. Ist nextCursor null, bist du am Ende.

json

{  "items": [    { "id": "01J8ME9AZ2K3W7X4V5T6R7Q8S9", "amountCents": "-4250" },    { "id": "01J8ME9B1Q2W3E4R5T6Y7V8H9J", "amountCents": "-1899" }  ],  "nextCursor": "eyJjIjoiMjAyNi0wNi0yMlQxODowNDoxMS4xMjM0NTZaIiwiaSI6IjAxSjhNRTlCMVEyVzNFNFI1VDZZN1Y4SDlKIn0"}

Durch alles blättern

Übergib den vorherigen nextCursor als Query-Parameter cursor, um die nächste Seite zu holen. Die Seitengröße stellst du über limit ein (serverseitig begrenzt).

bash

curl -H "Authorization: Bearer vokse_sk_…" \  "https://api.vokse.ai/households/current/transactions?limit=100"

bash

# pass the previous nextCursorcurl -H "Authorization: Bearer vokse_sk_…" \  "https://api.vokse.ai/households/current/transactions?limit=100&cursor=eyJjIjoiMjAyNi0wNi0yMlQxODowNDoxMS4xMjM0NTZaIiwiaSI6IjAxSjhNRTlCMVEyVzNFNFI1VDZZN1Y4SDlKIn0"

Gut zu wissen

Cursor sind opak. Parse oder baue sie nicht selbst.
Ein Cursor bleibt gültig, auch wenn neue Zeilen dazukommen; du überspringst keine Zeilen.
limit ist eine Obergrenze; der Server kann weniger Zeilen zurückgeben als angefordert.