Elements API – 2025-10-10 Päivitys

Uusi API Endpoint: Tapahtumapäivitykset

Olemme lisänneet osoitteeseen Elements API uuden päätepisteen, joka tarjoaa ohjelmallisen pääsyn tapahtumien päivityshistoriaan.

Loppupisteen tiedot

GET /tapahtumat/v1/päivitykset

Kuvaus

Tämä päätepiste hakee tiettyyn tapaukseen tehtyjen muutosten täydellisen historian (Broad Context Detection). Kukin päivitys edustaa tapahtumaan sen elinkaaren aikana tehtyä muutosta, mukaan lukien tilamuutokset, havaintojen lisäykset, kommentit ja muut muutokset.

Keskeiset ominaisuudet

Seuratut päivitystyypit

• Tilanmuutokset (patch)
• Ilmaisimien lisäykset, poistot ja muutokset
• Käyttäjän kommentit
• Vastatoimet
• Tapahtumien yhdistäminen
• Riskitason mukautukset
• Kategorian muutokset
• Uhkatutkimuksen ja validoinnin tulokset

Valtion seuranta

Jokainen päivitys sisältää stateBefore- ja stateAfter-objektit, joiden avulla näet tarkalleen, mikä muuttui. Näihin kuuluvat tila, ratkaisu, riskitaso ja luokat.

Alkuperää koskevat tiedot

Päivitykset sisältävät source -tiedot, joista käy ilmi, onko muutoksen tehnyt:

• Käyttäjä (näyttönimi)
• Automaattinen moottori
• Vastatoimi

Paginointituki

Tulokset voidaan sivuttaa käyttämällä ankkuripohjaista navigointia, ja määritettävissä oleva raja on 1-100 päivitystä pyyntöä kohden (oletus 50).

Suodatus

Suodata päivitykset tyypin mukaan, jotta voit hakea vain asiaankuuluvat muutokset (esim. vain kommentit tai vain tilamuutokset).

Asiakkaan edut

1. Täydellinen kirjausketju: Pääset käsiksi tapahtumamuutosten koko historiaan vaatimustenmukaisuutta ja raportointia varten.
2. Vastuullisuus: Alkuperäseurannan avulla voidaan tunnistaa, kuka on tehnyt tietyt muutokset tapahtumiin.
3. Integrointituki: Rakenna automatisoituja työnkulkuja, jotka reagoivat tietyntyyppisiin tapahtumapäivityksiin.
4. Muutosanalyysi: Vertaile ennen ja jälkeen -tilanteita, jotta ymmärrät tapahtuman kehittymisen.
5. Tehokas tiedonhaku: Käytä tyypin suodatusta hakeaksesi vain asiaankuuluvat päivitykset, mikä vähentää tarpeetonta tiedonsiirtoa.
6. Skaalautuvuus: Paginointituki mahdollistaa sellaisten tapausten käsittelyn, joilla on laaja päivityshistoria.

Lue lisää Elements API erittely sivulla kohdassa ”Get Incident Updates”.