Guía

Paginación

Los endpoints de listado paginan con un cursor opaco. Nunca calculas desplazamientos: sigues nextCursor hasta que sea null. Los cursores son estables ante escrituras concurrentes, así que nunca te saltas ni lees dos veces una fila.

La estructura de la respuesta de listado

Una respuesta de listado envuelve sus filas en items y devuelve un nextCursor. Cuando nextCursor es null, has llegado al final.

json

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

Recorrerlo todo

Pasa el nextCursor anterior como parámetro de query cursor para obtener la siguiente página. Ajusta el tamaño de página con limit (limitado en el servidor).

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"

Conviene saberlo

Los cursores son opacos: no los parsees ni los construyas tú mismo.
Un cursor sigue siendo válido aunque se inserten filas nuevas; no te saltarás ninguna fila.
limit es un límite superior; el servidor puede devolver menos filas de las solicitadas.