Varade API

Siin saab hallata organisatsiooni infovarasid, nende klassifikatsiooni ja seoseid äriprotsesside, riskide ja meetmetega.

POST /assets/

Uue vara loomine.

Väli	Tüüp	Kohustuslik	Kirjeldus
title	string	Jah	Kordonis kuvatav nimi.
description	string	Jah	HTML-vormingus kirjeldus.
manager_id	UUID	Jah	Vara halduri kasutaja ID.
owner_id	UUID	Jah	Vara omaniku kasutaja ID.
asset_value	string	Jah	Väärtus: low (madal), medium (keskmine) või high (kõrge).
state	string	Ei	Elutsükli staatus: live (kasutuses), planned (planeeritud) või deprecated (mahakantud). Vaikimisi live.
label_ids	array	Ei	Massiiv siltide UUID-dest, mida varale lisada.

curl --location 'https://SINU_KORDONI_DOMEEN/api/v1/assets/' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer SINU_VÕTI' \
--data '{
    "asset": {
        "title": "Uus vara nimi",
        "manager_id": "98dcb717-al70-4c89-8246-0bb026wc215b",
        "owner_id": "98dcb717-al70-4c89-8246-0bb026wc215b",
        "asset_value": "medium",
        "state": "live",
        "description": "<p>See on loodud API kaudu</p>",
        "label_ids": ["81bb6227-005f-4b1e-bf11-fbb9b96adb4d"]
    }
}'

Vastuse näide:

Loomispäringu vastus sisaldab loodud objekti täielikke andmeid.

Staatus 200

{
    "data": {
        "id": "4c38aec4-989f-4f1d-85ce-fcad34820716",
        "asset_value": "medium",
        "controls": [],
        "created_at": "2024-08-28T14:27:26+00:00",
        "description": "<p>See on loodud API kaudu</p>",
        "has_empty_controls": true,
        "has_failing_controls": false,
        "has_not_mitigated_risks": false,
        "labels": [],
        "manager": {
            "id": "98dcb717-al70-4c89-8246-0bb026wc215b",
            "name": "Jaana Manana"
        },
        "most_problematic_connection": {},
        "owner": {
            "id": "98dcb717-al70-4c89-8246-0bb026wc215b",
            "name": "Jaana Manana"
        },
        "risks": [],
        "state": "live",
        "sum_of_risk_scores": 0,
        "tasks": [],
        "title": "Uus vara nimi",
        "updated_at": "2024-08-28T14:27:26+00:00"
    }
}

GET /assets/:id

Vara pärimine ID järgi.

curl --location --request GET 'https://SINU_KORDONI_DOMEEN/api/v1/assets/580ee34d-4634-43b5-b082-952fdf4bd9b3' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer SINU_VÕTI'

Vastuse näide

Staatus: 200

{
    "data": {
        "id": "580ee34d-4634-43b5-b082-952fdf4bd9b3",
        "asset_value": "medium",
        "business_processes": [],
        "controls": [],
        "created_at": "2025-02-06T13:49:49+00:00",
        "description": "<p>Siin on kirjas midagi</p>",