Organisatsiooni autentimine API kaudu andmete edastamiseks

Selleks, et organisatsioon saaks hakata  API kaudu andmeid edastama, on vaja teha järgmised sammud.

Eeldus: kasutajal on organisatsiooni kasutaja õigused (vt Organisatsiooni lisamine ja kasutajate õigused ATV-s).

API võtme genereerimine.

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.

API võtme kasutamine ATV API-ga.

Kopeeri genereeritud võtme ID ja API võti ning kodeeri base64 formaadile kujul “API võtme ID” + ”:” + ”API võti”. Geneeritud koodi tuleb hoida alles edaspidiseks tokenite genereerimiseks (võti luuakse üks kord kuni selle aegumiseni aasta pärast).

Seejärel saada /auth/key-login otspunktile POST päring, mis sisaldab "X-API-KEY" header parameetrit, mille väärtus on eelnevalt kodeeritud sõne. Selle peale tagastatakse juurdepääsutoken API päringute jaoks, mida kasutatakse bearer-tokenina (auth type). Token kestab 15 minutit ning luuakse uuesti iga kord, kui soovitakse API kaudu andmeid edastada.

API võtme seadistamine RIHAKEse kasutajale.

Lisa saadud võti ja kood RIHAKEse konfiguratsioonifaili. Edaspidi saad saata RIHAKEsest automaatselt andmeid ATVsse.