eewookskehittäjille
Version 0.2 dokumentaatioAPI 0.2.0 on käytössä ja varmennettu. Tarkista saatavuus ennen integraation käyttöönottoa.

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

  1. Kutsu list_drives- tai list_work_sessions-työkalua parametreilla from, to, pagination: "snapshot" ja valitsemallasi limit-arvolla. Jätä cursor ja offset pois.
  2. Käsittele palautuneet rivit ja säilytä niiden lähdetunnisteet omassa järjestelmässäsi.
  3. Jos next_cursor ei ole null, toista sama työkalu, aikaväli, kuljettajarajaus, sivukoko ja sivutustapa. Lisää cursor: next_cursor.
  4. Jatka, kunnes next_cursor on null, 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.

Ewooksin kehittäjäohjeet · Päivitetty 21.11.2026 · Esimerkkitiedot ovat synteettisiä