Sivutus ja tilannekuvat¶
Käytä version 0.2 palvelimella pagination: "snapshot", kun haluat hakea koko rajatun aineiston. Oletuksena säilyvä offset näyttää muuttuvan aineiston: lisäykset, muokkaukset ja poistot voivat siirtää sen sivurajoja.
Tilannekuvan lukeminen¶
- Kutsu
list_drives- tailist_work_sessions-työkalua parametreillafrom,to,pagination: "snapshot"ja valitsemallasilimit-arvolla. Jätäcursorjaoffsetpois. - Käsittele palautuneet rivit ja säilytä niiden lähdetunnisteet omassa järjestelmässäsi.
- Jos
next_cursorei olenull, toista sama työkalu, aikaväli, kuljettajarajaus, sivukoko ja sivutustapa. Lisääcursor: next_cursor. - Jatka, kunnes
next_cursoronnull, myös tyhjän sivun jälkeen.
{
"from": "2026-11-20",
"to": "2026-11-20",
"pagination": "snapshot",
"limit": 100,
"cursor": "<edellisen vastauksen next_cursor sellaisenaan>"
}
Kursori on läpinäkymätön tunniste, jonka sisältöä ei tulkita tai muokata. Se on sidottu tunnistettuun käyttäjään, fleetiin, resurssityyppiin, hakuun ja sivukokoon. Se ei korvaa tunnistautumista eikä säilytä pääsyä avaimen sulkemisen tai oikeuksien poistumisen jälkeen.
Rajat¶
| Raja | Version 0.2 toiminta |
|---|---|
| Sivukoko | 1–100 tietuetta, oletus 25 |
| Aikaväli | Enintään 366 päivämäärää alku- ja loppupäivä mukaan lukien; muoto YYYY-MM-DD |
| Tilannekuvan voimassaolo | 15 minuuttia luonnista |
| Aktiiviset tilannekuvat | Enintään 3 fleetiä kohti, molempien listatyökalujen yhteinen kiintiö |
| Tilannekuvan rivimäärä | Enintään 10 000 |
| Tilannekuvan JSON ennen salausta | Enintään 4 MiB, oikeuskontekstin sisältävä kuori mukaan lukien |
Liian suuri tilannekuva hylätään, eikä aineistoa katkaista huomaamatta. Jaa aikaväli pienempiin hakuihin. Älä luo tarpeettomasti useita tilannekuvia.
Mikä säilyy vakaana?¶
Lähdearvot ja järjestys tallennetaan tilannekuvaa luotaessa. Myöhemmät lisäykset eivät tule samaan tilannekuvaan eivätkä tavalliset muokkaukset siirrä sen rivejä sivulta toiselle.
Nykyiset käyttöoikeudet ja yksityisyysrajat tarkistetaan silti. Rivi jätetään pois, jos se on poistettu, siirretty toiseen fleetiin tai luokiteltu yksityiseksi/tuntemattomaksi. Sivu voi siksi olla lyhyt tai tyhjä vaikka jatkokursori ei ole null. Älä tulkitse puuttuvaa riviä luotettavaksi poistotapahtumaksi.
Uusi tilannekuva voi sisältää samasta tietueesta uudemmat arvot. Tilannekuvakursori on lyhytikäinen sivutustunniste, ei jatkuvan synkronoinnin pysyvä jatkokohta.
Offset-sivutus¶
Aiemmat asiakkaat voivat käyttää kenttiä limit, offset ja next_offset. Suurin hyväksytty offset on 10 000. Älä yhdistä offset-arvoa tilannekuvasivutukseen tai käytä tilannekuvakursoria offset-tilassa.
Offset ei jäädytä aineistoa. Taloushallinnon vientiin tai täsmäytykseen käytä tilannekuvaa ja huomioi tiedon elinkaaren säännöt.