Guida

Paginazione

Gli endpoint di lista paginano con un cursore opaco. Non calcoli mai un offset: segui nextCursor finché non diventa null. I cursori restano stabili anche con scritture in corso, quindi non salti né rileggi mai una riga.

Il formato della lista

Una risposta di lista racchiude le righe in items e restituisce un nextCursor. Quando nextCursor è null sei arrivato alla fine.

json

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

Scorrere tutto

Passa il nextCursor precedente come parametro di query cursor per ottenere la pagina successiva. Regola la dimensione della pagina con limit (con un tetto lato server).

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"

Buono a sapersi

I cursori sono opachi: non interpretarli e non costruirli da te.
Un cursore resta valido anche se nel frattempo vengono inserite righe nuove: non ne salterai nessuna.
limit è un massimo: il server può restituire meno righe di quelle richieste.