Integroituminen Sentraan
- Lemonsoft
- Markus Litmanen
Sentran käyttäminen edellyttää tilin käyttäjähallintaan ja oikeudet yritykseen jonka nimissä integraatio tehdään. Käyttäjätilin lisäksi Sentraan integroituvalla yrityksellä tulee olla Sentran yrityskohtainen API-avain joka toimitetaan Sentra-tiimin toimesta.
API-avaimen toimittamiseen vaaditut tiedot ovat yrityksen nimi, y-tunnus ja yksikkö. Tämän lisäksi vaaditaan aktiiviset kolmannen osapuolen rajapintapintatunnukset jotka välitetään Sentralle sanomien yhteydessä.
💡Lisätietoja Lemonsoftin käyttäjähallinnasta löydät täältä: Käyttäjähallinta
On tärkeää huomioida, että Sentran API-avaimet ovat ympäristökohtaisia. Tämä tarkoittaa, että siirryttäessä testiympäristöstä tuotantoympäristöön on käytettävä erillisiä API-avaimia.
Sentra tarjoaa kehittäjille testiympäristön jota voidaan hyödyntää Lemonsoftin testiympäristöjen kanssa, integraatiot Lemonsoftin tuotantoympäristöihin toteutetaan aina Sentran tuotantoympäristössä.
Sentra tarjoaa kehittäjille API-dokumentaation, Home joka on tällä hetkellä kehitysvaiheessa. Pääsy dokumentaatioon edellyttää tunnistautumista. Tunnukset testiympäristön API-dokumentaatioon voi pyytää Sentra-tiimiltä.
Sentran osoitteet
Tuotantoympäristö: https://sentra.lemonsoft.eu/sentra/
Testiympäristö: https://sentra.dev.lemonsoft.io/sentra/
Kirjautuminen käyttäjätunnuksella ja salasanalla
POST https://sentra.lemonsoft.eu/sentra/api/v1/auth/login
Kyselyn otsikkotietueet:
Sentra-Api-Key: [[Yrityksen Sentra API-avain]]
Kyselyn sisältö:
{ "username": [[Tunnus Lemonsoftin käyttäjähallintaan]], "password": [[Salasana Lemonsoftin käyttäjähallintaan]] }
Kirjautuminen Lemonsoftin käyttäjähallinan todennustunnisteella/tokenilla
POST https://sentra.lemonsoft.eu/sentra/api/v1/auth/login/token
Kyselyn otsikkotietueet:
Sentra-Api-Key: [[Yrityksen Sentra API-avain]]
Kyselyn sisältö:
{ "token": "eyJhbGciOiJSUzI1Ni...iYoZbYh-4Xe-R9I_nFoyNWgqbzxb" }
Onnistunut kirjautuminen palauttaa käyttäjälle Sentran SessionId jota tarvitaan integraatioissa palveluiden välillä. Kirjautumisen jälkeen pakolliset kyselyn otsikkotietueet sisältävät aina Sentra-Api-Key ja SessionId avaimet.