RIHA kataloogi poole pöördumiseks on võimalik kasutada ka masinliidest, mille abil on võimalik RIHA-s olevaid andmeid töödelda, siduda muude andmetega, luua lisaväärtust andvaid rakendusi jms.

Masinliidese kaudu saab pärida infosüsteemide kirjeldusi, samuti andmeid arutelude (Issues), kommentaaride (Comments) ning andmeobjektide (Data Objects) kohta.

RIHA API aadress on https://www.riha.ee/api/v1 API on kirjeldatud Swagger OpenAPI v3.0.1 vormingus, kirjelduse asukoht on https://www.riha.ee/api-docs. Abiks võib olla ka RIHA andmete JSON-skeem.

Näide RIHA API kasutamisest: RIHA aktiivsusmonitor (lähtekood).

Järgnevalt on toodud mõned näited päringutest, mida saab proovimiseks sisestada otse veebilehitseja aadressiribale.

Kõigi infosüsteemide nimekirja saamiseks kasutage päringut https://www.riha.ee/api/v1/systems

Tulemusena kuvatakse infosüsteemide nimekiri koos lühiandmetega masinloetaval kujul (JSON-vormingus).

Kuna infosüsteeme on palju, väljastatakse andmed lehekülgede kaupa. Päringu vastus algab infosüsteemide arvuga "totalElements":1708, sellele järgneb element "content" infosüsteemide kirjeldustega. Vastuse lõpus on lehekülje number, lehekülgede arv ja lehekülje suurus (ehk korraga kuvatud infosüsteemide arv): "page":0,"totalPages":84,"size":20.

Lehekülje suurust ja hetkel kuvatavat lehekülge saab päringus seadistada. Näiteks päring https://www.riha.ee/api/v1/systems?size=50&page=2 seab korraga väljastatavaks infosüsteemide arvuks 50 ja kuvatakse teine lehekülg.

Infosüsteemi detailse kirjelduse saamiseks tuleb päringule lisada infosüsteemi lühinimi, näiteks https://koolitus.riha.ee/api/v1/systems/riha-test

Konkreetse infosüsteemi kohta avatud arutelude (Issues) nimekirja saab kätte näiteks päringuga https://koolitus.riha.ee/api/v1/systems/riha-test/issues

Konkreetse arutelu sees sisalduvad kommentaarid saab kätte päringutega https://koolitus.riha.ee/api/v1/issues/10857 ja https://koolitus.riha.ee/api/v1/issues/10857/comments (eeldab RIHA-sse sisselogimist kirjeldaja või hindaja õigustes).

Järgnev päring illustreerib filtri, kuvatavate väljade loetelu ning sorteerimiskriteeriumi kasutamist, kuvades staatusega kasutusel infosüsteemide omaniku andmed, infosüsteemi nime ja metaandmed, sorteerituna omaniku nime järgi: https://www.riha.ee/api/v1/systems?filter=meta.system_status.status,jilike,IN_USE&fields=owner,name,meta&size=2000&sort=owner.name

Ja veel üks näide: https://www.riha.ee/api/v1/systems?filter=owner.name,jilike,%25Riigi%20Infos%C3%BCsteemi%20Amet%25,meta.system_status.status,jilike,IN_USE,topics,jilike,%25Info%C3%BChiskond%25&fields=owner,name,topics,contacts&sort=name&size=50

Kuvatakse nende infosüsteemide omanik, nimi, märksõnad ja kontaktid, kus omaniku nimeks on Riigi Infosüsteemi Amet, süsteemi staatuseks on kasutusel ning märksõnade loetelu sisaldab märksõna Infoühiskond. Väljund on sorteeritud infosüsteemi nime järgi ning tulemused väljastatakse 50 kirje kaupa.

Näide andmeobjektide päringu kohta: https://www.riha.ee/api/v1/systems/data-objects?filter=searchName,ilike,%25riha%25&size=600&sort=dataObjectName

Selle päringu tulemusena kuvatakse infosüsteemi lühinimega „riha“ andmeobjektid, järjestatuna andmeobjekti nime alusel kasvavas järjestuses.