Kaikki Työajan API viestit vaativat tunnistautumisen Nepton-palvelussa olevan henkilön tunnuksilla ja sovellusliittymän käyttöoikeudet ovat samat kuin kyseiselle henkilölle on asetettu Neptoniin.
On suositeltavaa, että jokaiselle sovellusliittymää käyttävälle ratkaisulle perustetaan oma henkilö eli käyttäjätunnus. Näitä käyttäjätunnuksia ei käytetä mihinkään muuhun tarkoitukseen kuin API:n käyttöön. Ks. ohje henkilön lisäämiseksi.
Tunnistautumista varten kutsussa yhtenä SOAP elementtinä tulee olla CallerAuthentication-elementti.
Tunnistautuminen
CallerAuthentication-elementissä on tunnistautumistiedot. Standardoiduille toiminnoille tunnistautumisessa käytettävät kentät ovat:
- CustomerId - Työyhteisön Id-numero. Ota yhteyttä asiakaspalveluun saadaksesi oikean arvon.
- Username - Nepton-palveluun tallennetun henkilön käyttäjätunnus.
- Password - Em. henkilön salasana. HUOM. Salasana ei voi päättyä &-merkkiin, rikkoo XML-sanoman.
Muut tunnistautumiseen liittyvät kentät, jotka on listattu API kuvauksessa ovat ainoastaan sisäiseen käyttöön.
Esimerkki
<CallerAuthentication>
<CustomerId>xxxxxxxxx</CustomerId>
<Username>xxxxxxxxx</Username>
<Password>xxxxxxxxx</Password>
</CallerAuthentication>