API autorizācija

Lai izmantotu API, pakalpojuma sniedzēja lietotnei ir jānosūta pieprasījumi, izmantojot TLS, un jāveic autentifikācija atbilstoši HTTP Basic Authentication shēmai (RFC 2617), izmantojot API atslēgu.

API atslēgu izsniedz LVRTC, reģistrējot pakalpojuma sniedzēju kā e-Identitātes platformas klientu.

Pakalpojuma sniedzēja lietotnei API pieprasījumu Authorization galvenē (header) jāiekļauj API atslēga šādā formātā:

Authorization: Basic {API-key}

kur {API-key} ir rezultāts, kas iegūts, kodējot lietotnes klienta identifikatoru (client_id) un slepeno atslēgu (client_secret) šādi:

base64(url_encode(utf8(client_id)) ':' url_encode(utf8(client_secret)))

Iepriekš minētā pseido-koda nozīme:

• Vispirms kodējiet client_id UTF-8 formātā, pēc tam piemērojiet URL kodēšanu (URL encoding).
• Vispirms kodējiet client_secret UTF-8 formātā, pēc tam piemērojiet URL kodēšanu (URL encoding).
• Savienojiet abas vērtības, izmantojot kolu (:) kā atdalītāju.
• Iegūto virkni kodējiet Base64 formātā bez rindu pārtraukumiem.