NetBaron REST-API avausohje
1. Yleistä
NetBaron REST-rajapinnan avulla toteutat tiedonsiirron muihin järjestelmiin vaivatta. Ota yhteyttä myyntiimme tai NetBaron-yhteyshenkilöösi saadaksesi lisätietoa rajapintojen mahdollisuuksista ja aloittaaksesi rajapintaintegraatio.
📧 Sähköposti: myynti@netbaron.fi 
Kotisivut: https://confirma.fi/netbaron/
Käytettävästä rajapinnasta riippuen seuraavat toiminnot ovat tuettuna. Rajapintakohtaiset metodit ja parametrit löytyvät rajapinnan dokumentaatiosta.
Tiedonhaku (GET)
Tiedon luonti (POST)
Tiedon päivitys (PUT)
Tiedon poistaminen (DELETE)
Kaikki tiedot kulkevat suojatusti HTTPS-protokollan avulla.
2. Yhteyden avaaminen
Lyhyesti REST-rajapintayhteyden avaaminen NetBaroniin edellyttää seuraavia asioita:
Pyydä API-avain, jolla toinen järjestelmä tunnistautuu NetBaroniin. Pääsyavain toimitetaan integraation toteuttajalle.
Testaa yhteys
GET /auth/validate-päätepisteellä.Toteuta integraatio oman järjestelmänne rajapintakutsujen avulla.
Testaa toiminnallisuus osoitetussa testiympäristössä.
Siirry tuotantoympäristöön: Ilmoita avauksessa osoitetulle NetBaron yhdyshenkilölle tai tukeen, että rajapintaintegraatio on valmis tuotantoon siirtoa varten. Laskutus käynnistyy tuotantorajapintojen avauksesta.
Aloita käyttö!
Tarvittaessa integraatioprojektille on järjestettävissä aloituskatselmointi Teamsin välityksellä, jossa käydään läpi tarkemmin projektin vaiheet ja tavoitteet sekä voimme vastata askarruttaviin kysymyksiin rajapintojen käytöstä. Aloituskatselmointiin osallistuvat asiakas, integroinnin toteuttaja sekä NetBaronin projektivastaava.
3. Dokumentaatio
Tekniset rajapintakuvakset löytyvät osoitteesta:
https://help.netbaron.fi/instructions/open-api-documentation
4. Testiympäristö
Rajapintaintegraatiota varten avataan testiympäristö, missä toteutus ja toiminnallisuudet tulee vahvistaa ennen tuotantoon siirtoa. Testausorganisaatio avataan tyypillisesti samalle palvelimelle, jossa itse tuotanto-organisaatio on.
Kun integraation toteutus on todettu testiorganisaatiossa valmiiksi, voidaan avata tuotanto-organisaatioon rajapinnat ottamalla yhteyttä avauksessa osoitettuun projektivastaavaan tai NetBaronin tukeen.
Testiorganisaatio on oletuksena voimassa 12 kuukauden ajan projektin aloituksesta.
Base URL:
https://1.netbaron.fi/api/v1Palvelimesta riippuen osoitteen ensimmäinen numero on väliltä 1 - 8
5. Tuki ja yhteydenotto
Asiantunteva tiimimme on valmis auttamaan sinua kaikissa vaiheissa, jotta voit hyödyntää järjestelmämme tarjoamia mahdollisuuksia täysimääräisesti. Älä jää yksin – yhdessä voimme luoda tehokkaan ja sujuvan integraation, joka tukee tavoitteitasi ja parantaa asiakaskokemustasi.
📧 Sähköposti: tuki@netbaron.fi
📞 Puhelin: 0600 302 112 (1,98 €/min + mpm/pvm)
🕒 Aukioloajat: Ma–Pe klo 8.00-16.00