Linkity Core API:
Linkity saumattona osana kokonaisuutta

Core API on Linkityn julkinen REST-rajapinta. Sen kautta luet ja päivität henkilöstö-, työvuoro-, työaika- ja poissaolotietoja suoraan omista järjestelmistäsi – ilman käsin tehtäviä siirtoja ja päällekkäistä kirjaamista.

Core API on saatavilla Linkity-asiakkaille sopimuksen mukaan.

Ota yhteyttä

Lue API-dokumentaatio

Linkityn työvuorosuunnittelu tukee liiketoiminnan sujuvuutta ja henkilöstön hyvinvointia.

Yksi tietolähde

Henkilöstö-, työaika- ja poissaolotiedot samasta paikasta. Ei rinnakkaisia Excel-listoja eikä ristiriitaisia versioita.

Ajantasainen tieto

Nouda vain muuttuneet tiedot aikaleiman perusteella ja pidä järjestelmät ajan tasalla haluamallasi rytmillä.

Kehittäjäystävällinen

Selkeä REST-rakenne, JSON-vastaukset ja versioitu rajapinta. Tuttua tekniikkaa millä tahansa kielellä.

Testaa ensin

Rakenna ja varmista integraatio erillisessä testiympäristössä, ennen kuin viet sen tuotantoon.

Esimerkkejä siirrettävästä tiedosta

Core API kattaa kolme Linkityn ydinaluetta. Tarkat resurssit, kentät ja esimerkkipyynnöt löytyvät dokumentaatiosta.

Henkilöstö ja organisaatio

Työntekijöiden perustiedot
Työsuhteet ja niiden voimassaolo
Kustannuspaikat ja organisaatiorakenne
Yksiköt, tiimit ja esihenkilösuhteet

Tyypillisiä käyttötapoja

Organisaatiodatan vieminen raportointiin
Henkilöstötietojen pitäminen ajan tasalla muissa järjestelmissä
Käyttäjätunnusten ja käyttöoikeuksien hallinta
Yksiköt, tiimit ja esihenkilösuhteet

Työvuorot ja työaika

Työvuorosuunnitelmat ja suunnitellut vuorot
Toteutuneet työajat ja leimaukset
Työaikatapahtumien kohdistukset

Tyypillisiä käyttötapoja

Resursointi toiminnanohjaus- tai tuotantojärjestelmässä
Leimaustietojen tuonti omista laitteista tai sovelluksesta
Työajanseuranta ja mittarit BI-työkalussa

Poissaolot ja lomat

Vuosilomat sekä poissaolot ja niiden syyt
Poissaolojaksot ja niiden voimassaolo
Poissaolojen kohdistuminen työvuoroihin

Tyypillisiä käyttötapoja

Poissaolotietojen näyttäminen intranetissä tai omassa sovelluksessa
Poissaolojen huomioiminen resursoinnissa ja suunnittelussa
Poissaolojen seuranta ja raportointi

Tekniset perusteet

Rajapinta on suunniteltu niin, että kokenut kehittäjä pääsee liikkeelle dokumentaation avulla.

REST ja JSON

HTTPS-yhteys, ennakoitavat resurssipolut ja JSON-muotoiset pyynnöt sekä vastaukset.

Autentikointi API-avaimella

Jokainen kutsu tunnistetaan asiakkaalle myönnetyllä API-avaimella.

Versioitu rajapinta (v1)

Versiointi pitää olemassa olevat integraatiot toimintakuntoisina rajapinnan kehittyessä.

Sivutus ja aikaleimasuodatus

Nouda suuria tietomääriä hallitusti tai vain viimeisimmät muutokset.

Testiympäristö

Erillinen testiympäristö kehitykseen ja hyväksyntätestaukseen.

Selkeät virhevastaukset

Vakioidut HTTP-statuskoodit ja kuvaavat virheilmoitukset vianselvitystä varten.

Näin pääset alkuun

Ota yhteyttä. Käydään läpi käyttötapaus ja se, mitä tietoja integraatio tarvitsee.
Saat pääsyn testiympäristöön. Toimitamme testiympäristön ja API-avaimen kehitystä varten.
Rakennat ja testaat integraation. Kehitystyö etenee dokumentaation avulla omalla tai kumppanin tiimillä.
Siirrytään tuotantoon.
Varmistetaan yhdessä, että tiedot liikkuvat oikein, ja otetaan integraatio käyttöön.

Ota yhteyttä

Kerro, mihin järjestelmään Linkity pitäisi yhdistää – katsotaan yhdessä, miten Core API sopii siihen ja miten käyttöönotto etenee.

Usein kysytyt kysymykset

Kuka voi käyttää Core API:a?

Rajapinta on Linkity-asiakkaiden käytettävissä sopimuksen mukaan. Kerromme mielellämme, mitä käyttöönotto teidän kohdallanne tarkoittaa.

Tarvitsemmeko oman kehittäjän?

Integraation toteuttaa tekninen tekijä – oma kehitystiimi, järjestelmätoimittaja tai integraatiokumppani. Linkityn tuki auttaa rajapintaan liittyvissä kysymyksissä.

Voimmeko testata ennen tuotantokäyttöä?

Kyllä. Kehitys ja testaus tehdään erillisessä testiympäristössä, joten tuotantodataan ei kosketa ennen kuin integraatio on valmis.

Mitä dokumentaatiossa on?

Dokumentaatiosta löytyvät rajapinnan resurssit, kentät, esimerkkipyynnöt ja virhekoodit. Se on avoimesti luettavissa osoitteessa api-test.linkity.net/docs.

Korvaako rajapinta nykyiset integraatiomme?

Core API on tarkoitettu uusien integraatioiden rakentamiseen ja olemassa olevien laajentamiseen. Käydään yhdessä läpi, mikä on teidän ympäristössänne paras tapa edetä.

Ratkaisut

Roolit