Palveluntuottajarajapinnan vaatiman API-avaimen luonti
- Jenni Hopeela (Unlicensed)
- Jani Grönberg
Mikäli palveluntuottaja haluaa ottaa käyttöön PSOPiin toteutetun palveluntuottajarajapinnan omaan toiminnanohjausjärjestelmään, tulee ensin varmistaa, että oma toiminnanohjausjärjestelmä on integroitu PSOP-järjestelmään. Tämän saat varmistettua omalta palvelunjärjestäjältäsi!
Palveluntuottajarajapinnan käyttö vaatii tämän lisäksi API-avaimen, joka on palveluntuottajakohtainen tunnistenumero, jolla tiedetään, mikä palveluntuottaja lähettää tapahtumia PSOP-järjestelmään. API-avain luodaan PSOPissa ja viedään sen jälkeen omaan toiminnanohjausjärjestelmään oman toiminnanohjausjärjestelmätoimittajan ohjeistuksen mukaisesti.
Ohje API-avaimen luontiin
Kirjaudu järjestelmään palveluntuottajana.
Kirjaudu vaihtoehdosta “hallinnoi palveluntuottajahakemuksia”.
Tunnistaudu järjestelmään vahvan tunnistuksen avulla.
Hyväksy henkilötietojen käyttö tunnistautuessa.
Valitse yritys, jonka puolesta olet asioimassa.
Mikäli olet kirjautunut järjestelmään jo aikaisemminkin, päädyt järjestelmän etusivulle. Muussa tapauksessa sinua pyydetään täyttämään ensin yrityksen tiedot, joten täytä ne.
Etusivulta löytyy kohta “Yrityksen tiedot”, johon ohjataan suoraan, mikäli kirjaudut ensimmäistä kertaa.
Yrityksen tietojen alta löytyy kohta “Integraatiot”, josta löytyy uuden API-avaimen luonti.
Anna API-avaimelle tunniste (nimi), joka kertoo sen, missä sitä käytetään, esim. toiminnanohjausjärjestelmän nimi.
Syötä API-avaimelle vanhenemispäivä, voimassaoloaika maksimissaan 1 vuosi.
Paina lopuksi “Luo uusi avain”.
Kopioi uusi avaimesi painamalla avaimen edessä olevaa kopiointi-ikonia. Avain on kopioitavissa vain sivun uudelleen lataamiseen asti, eikä sitä voi enää sivulatauksen jälkeen palauttaa.
Tarkista järjestelmän antamat ohjeet tunnisteen kopioimiseksi toiminnanohjausjärjestelmään.
Voit hallinnoida avaimia ja poistaa niitä käytöstä tarpeen mukaisesti.
Huom! Käytöstä poistettua avainta ei saa palautettua, tee tarvittaessa uusi.