Organisatsiooni autentimine API kaudu andmete edastamiseks

Selleks, et organisatsioon saaks hakata  API kaudu andmeid edastama, on vaja teha järgmised sammud. Eeldusena peavad kasutajal olema organisatsiooni kasutaja õigused (vt Organisatsiooni lisamine ja kasutajate õigused ATV-s):

1. Logi sisse enda kontoga, ava Seaded → nupp "Masinliidestuse seaded" → nupp "Lisa uus võti". Võtit näidatakse üks kord ning kestab ühe aasta.  Võtme aegumist peab jälgima kasutaja ise.

2. Kopeeri avanenud aknast (API võtme ID:API võti) ning see tuleb kodeerida base64 formaadile vastaval kujul. 

3. Geneeritud koodi tuleb hoida alles edaspidi tokenite genereerimiseks (võti ise luuakse üks kord). RIHAKEses lisatakse kood konfifaili.

Seejärel POST päring /auth/key-login, kus on "X-API-KEY" header, kuhu läheb genereeritud (API võtme ID:API võti) kood. Genereeritud tokenit kasutatakse bearer-tokenina (auth type), mida kasutada API päringutes. Token kestab 15 minutit ning luuakse uuesti iga kord, kui soovitakse API kaudu andmeid edastada.