Integraatiot voidaan toteuttaa Nepton API sovellusliittymän kautta. Pyytävä järjestelmä voi tehdä palvelupyyntöjä Nepton API:lle milloin tahansa. API sovellusliittymä mahdollistaa reaaliaikaiset integraatiot ja mahdollistaa välittömien palautuskoodien ja viestien käytön. Käytännössä API sovellusliittymää hyödynnetään mm. projektien tai tapahtumien tuonnissa Neptoniin, jolloin lähettävään järjestelmään tehtävät lisäykset tai muutokset päivittyvät reaaliajassa Neptoniin. API sovellusliittymän käyttö sisältyy kaikkiin Neptonin palvelutasoihin.
Neptonissa on API sovellusliittymälle 2 eri endpointtia, jonne kutsuja voidaan tehdä. Toisessa endpointissa on Henkilötietojen sovellusliittymät ja toisessa endpointissa Työajan toiminnot työaika, projektit ja poissalot.
API liittymän käyttöönotto
- Työaikatapahtumien, poissaolojen tai projektien sovellusliittymän käyttöön tarvitaan CustomerId-tunnus, joka on saatavana Neptonilta. CustomerId on Työyhteisön Id-numero Nepton ympäristöä varten. Lisää työajan API:ssa tunnistautumiseen täältä.
- API-kutsut todennetaan. Todentaminen edellyttää henkilöiden kirjautumistietoja ja muutokset tietoihin kirjataan lokiin tämän käyttäjän suorittamana. Jokaiselle sovellusliittymää käyttävälle ratkaisulle tulee, hyvän tietoturvan takaamiseksi, perustaa oma henkilö eli käyttäjätunnus. Luomalla yksilölliset käyttäjätunnukset, saadaan myös lokeihin tiedot, mitä käyttäjätunnusta ja mitä API-toteutusta käytettiin API-kutsuissa. Näitä käyttäjätunnuksia ei käytetä mihinkään muuhun tarkoitukseen kuin API sovellusliittymän käyttöön. Hyvän tietoturvan takaamiseksi on suositeltavaa myöntää vain tarvittavat Neptonin roolit käyttäjätunnukselle, jota käytetään API-todennuksessa. Esimerkiksi jos sovellusliittymän toteutus ei käytä HR-tietoja, käyttäjätunnukselle tulee antaa rooli pienimmillä oikeuksilla HR-tietojen saamiseksi.
API liittymällä tuontia varten Neptoniin ei tarvita mallimuotoista tiedostoa. API mahdollistaa erilaisten datatietueiden tarkastelun ja hallinnan. API tarjoaa ulkoisista järjestelmistä pääsyn tiettyihin työajan toimintoihin. Tuettu tietosisältö sisältää:
- Henkilöstö-, työsuhde- ja muut henkilöihin liittyvät kentät
- Poissaolot
- Työaikakirjaukset, jotka ovat tapahtumia palvelussa
- Projektit, kustannuspaikat ja työmääräykset, jotka ovat työn kohdennuksia tai projekteja palvelussa
API liittymän käyttöönotto, aineiston vientiin
Neptonista mm. projektien tai tapahtumien viennissä tarvitaan edellä mainittujen määritysten lisäksi sääntöjoukkojen poimintasäännöt, joiden perusteella määriteltyä sisältöä viedään toiseen palveluun.