Üldkirjeldus

Teenus tagastab muutunud hindamise tulemused raportite koostamiseks päringus määratud ajavahemikus.

Eeltingimused ja kasutusõigused

Tegemist on masin-masin liidese päringuga. Vajalik eraldi autentimine süsteemse kasutajana.
Autentimiseks on vajalik päringus päisesse lisada:
- X-API-TOKEN
- vajaliku keskkonnapõhise väärtuse saab Rakendused, keskkonnad ja ligipääsud lehelt

Sisendid

Atribuut

Kohustuslikkus, mitmesus

Tüüp

Vaikeväärtus, valideerimine

Kirjeldus, täiendav info

from

1

OffsetDateTime

Formaat: YYYY-MM-DDTHH:mm:ss.sssTZ

Muudatuste alguskuupäev ja kellaaeg (sisend query parameetrina)

to

0..1

OffsetDateTime

Formaat: YYYY-MM-DDTHH:mm:ss.sssTZ

Vaikimisi hetkeaeg

Muudatuste lõppkuupäev ja kellaaeg (sisend query parameetrina)

Väljundid

Atribuut	Kohustuslikkus, mitmesus	Tüüp	Kirjeldus, täiendav info
events	0..*	Array	Nimekirja objektid sisaldavad infot vahemikus muutunud hindamiste kohta. Vahemikus leidunud muudatustest tagastatakse viimase muudatuse info
events.assessmentId	1	String	Hindamise identifikaator (ID)
events.status	1	String	Hindamise staatus. Võimalikud väärtused: UPDATED (kuvatakse, kui hindamine on lisandunud või hindamisega seotud sektsiooni elemente on uuendatud) DELETED (kuvatakse, kui hindamine on kustutatud)
events.date	1	DateTime	Hindamisega seotud viimase muudatuse kuupäev ja kellaaeg (ajatsooni info puudub, andmed on alati Eesti aja järgi).

Tegevused

Süsteem kontrollib, kas kasutajal on õigust päringut teostada.
1. Kui kasutajal ei ole õigust päringut teostada, siis lõpetatakse päringu töötlemine ja tagastatakse http veakood.
Süsteem kontrollib, kas andmed vastavad nõuetele.
1. Kui andmed ei vasta nõuetele, siis lõpetatakse päringu töötlemine ja tagastatakse http veakood.
Süsteem otsib hindamistega seotud muudatused.
- Süsteem otsib hindamise komponentide elemendid, mille:
  - modifiedAt on sisendis esitatud kuupäevade vahemikus
  - synchronizedToDwh = true
- Süsteem otsib komponentide elementidega seotud komponendid
Süsteem tagastab leitud andmed.

Näidisväljund

GET http://193.40.55.103:64838/api/internal/v1/assessments/events?from=2024-02-20T10:15:30%2B01:00&to=2024-02-28T10:32:30%2B02:00

NB! Väljundi andmestikku on vähendatud.

{
    "events": [
        {
            "assessmentId": "65cf268e8649720480357a05",
            "status": "UPDATED",
            "date": "2024-02-20T12:57:21.627"
        },
        {
            "assessmentId": "65cdf951864972048035791b",
            "status": "DELETED",
            "date": "2024-02-21T14:58:25.479"
        },
        {
            "assessmentId": "65dd9ac3a3635568034e4af1",
            "status": "UPDATED",
            "date": "2024-02-27T10:18:11.682"
        },
        {
            "assessmentId": "65de8324a3635568034e4ceb",
            "status": "DELETED",
            "date": "2024-02-28T02:58:46.251"
        },
        {
            "assessmentId": "65deef47a3635568034e503c",
            "status": "DELETED",
            "date": "2024-02-28T10:31:05.415"
        },
        {
            "assessmentId": "65deef8ca3635568034e5244",
            "status": "UPDATED",
            "date": "2024-02-28T10:32:14.831"
        }
    ]
}