Avalik arendaja viide

Planeeritud riiklikud endpointid — ühe pilguga.

Tähtpiilur tegutseb nelja Eesti riikliku API vastu, et väikeettevõtte omanik ei peaks kunagi ametniku portaali sisse logima, et esitada rutiinset deklaratsiooni.

Iga kaart allpool on tulevase liidestuse kuju eelvaade: HTTP-meetod ja URL-muster, volituste ja transpordi skeem ning kopeeritav päring kolmes stiilis. Spetsifikatsioonid on illustratiivsed — tegelik RIA / EMTA / MTÜ leping saab määravaks kohe, kui see väljastatakse.

emta

e-MTA · Maksu- ja Tolliamet

KMD, TSD ja palgaandmete otseedastus maksuametile (X-Road kaudu).

Planeeritud

Endpoint

POSThttps://emta-portal.test.ria.ee/declare/v1/kmd

X-Road security server · multipart/form-data with the signed XML in `form`

Autentimine

X-Road machine-cert

X-Road üksuse masinsertifikaat (eIDAS eestikeelne kvalifitseeritud sert). Vahetatakse X-Road turvaserveri pihta.

Näidispäring

curl -X POST https://emta-portal.test.ria.ee/declare/v1/kmd \
  -H "Content-Type: multipart/form-data" \
  -H "X-Road-Client: TAHTPIILUR/COMPANY" \
  --cert ./tahtpiilur-machine-cert.pem \
  --key  ./tahtpiilur-machine-key.pem \
  -F "form=@kmd-2026-08.xml;type=application/xml"

efaktura

e-Faktura · e-arveldaja (EN 16931)

B2B e-arvete saatmine ja vastuvõtmine EN 16931 masinloetavas vormis.

Eel-API

Endpoint

POSThttps://earved.arveldaja.test.ria.ee/v1/inbox

Body: EN 16931 UBL 2.1 invoice or CreditNote. Bearer token in Authorization header.

Autentimine

OAuth 2.0 · client credentials

OAuth 2.0 kliendi-salasõna grant (e-Faktura portaalist väljastatud client_id + client_secret). Vahetus toimub `/oauth/token` endpointil.

Näidispäring

curl -X POST https://earved.arveldaja.test.ria.ee/v1/inbox \
  -H "Authorization: Bearer YOUR_EFAKTURA_ACCESS_TOKEN" \
  -H "Content-Type: application/xml" \
  --data-binary @invoice-2026-08-001-ubl21.xml

ariregister

E-äriregister · E-ariregister

Majandusaasta aruande esitamine ja registriandmete pärimine.

Planeeritud

Endpoint

GEThttps://ariregister.rik.ee/api/v1/ettevotted/{regCode}/aruanded

`regCode` is the 8-digit business registry code. Response is JSON-LD.

Autentimine

mTLS

Vastastikune TLS — kliendi sertifikaat väljastatakse äriregistri MISP-is eraisiku või esindaja autentimiseks.

Näidispäring

curl https://ariregister.rik.ee/api/v1/ettevotted/12345678/aruanded \
  --cert ./ariregister-client-cert.pem \
  --key  ./ariregister-client-key.pem

tooinspektsioon

Tööinspektsioon · töösuhete register

Töölepingu sündmuste (puhkus, lõpetamine, haigusleht) elektroonne edastamine.

Planeeritud

Endpoint

POSThttps://api.ti.test.ria.ee/v1/events/leave

JSON body conforming to the TI event v1 schema. API key scoped per employer.

Autentimine

API key

Staatiline API-võti, väljastatakse tööandja kohta Tööinspektsiooni iseteeninduses. Päis `X-API-Key`.

Näidispäring

curl -X POST https://api.ti.test.ria.ee/v1/events/leave \
  -H "X-API-Key: YOUR_TI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "regCode": "12345678",
    "employeeId": "EE39102012345",
    "eventType": "ANNUAL_LEAVE_START",
    "from": "2026-08-14",
    "to":   "2026-08-28"
  }'

Praegu illustreeriv — lõplik endpointi kuju, baas-URL ja volituste väljastamine sõltuvad iga asutuse avaldatud API-poliitikast. Ükski allolev liidestus ei väljasta veel tootmisvolitusi; kõiki näidiseid tuleb käsitleda ainult illustratiivsena.