Sirio CloudDocumentazione API

Paginazione e sync

Scorrimento degli elenchi e sincronizzazione incrementale.

Il cursore

Gli elenchi si sfogliano con limite (fino a 100) e dopo, il cursore. Ogni pagina dice se ce n'è un'altra e da dove riparte:

GET /api/v1/clienti?limite=100
→ { "clienti": [ … ], "altri": true, "cursore": 4210 }

GET /api/v1/clienti?limite=100&dopo=4210
→ la pagina successiva

Il cursore è stabile: è l'id dell'ultima riga letta, con ordinamento sempre per id crescente. Lo scorrimento è interrompibile e riprendibile.

Il sync a delta

La stessa meccanica serve alla sincronizzazione incrementale: si conserva l'ultimo cursore e alla corsa successiva si richiede solo il nuovo. Sui movimenti di magazzino:

GET /api/v1/movimenti?dopo=901240&limite=100
→ i soli movimenti nati dopo l'ultima corsa

La ricetta completa è in Tenere allineato un altro sistema.

I filtri sul periodo (da/a) sono più costosi del cursore e sono adatti alle interrogazioni una tantum; per la sincronizzazione continua si usa il cursore. Un filtro scritto male non viene mai ignorato: risponde 422 filtro_non_valido.