API for andre systemer
Med en API-nøkkel kan et annet system, for eksempel lønnssystemet, regnskapet eller et eget rapportverktøy, lese data fra Timefly. Systemet kan bare lese. Det kan ikke endre, legge til eller slette noe i Timefly.
Hva kan systemet lese?
Du velger selv for hver nøkkel. Det finnes fem valg:
| Valg | Hva systemet får |
|---|---|
| Ansatte | Navn, e-post, telefon, stillingstittel, ansattnummer, ansatt fra og til, om personen er aktiv |
| Vakter | Publiserte vakter med tider, vakttype, prosjekt, stempling og om vakten er godkjent |
| Godkjente timer | Godkjente vakter med timer etter pause, regnet slik lønnen regner dem |
| Fravær | Godkjent fravær med fraværstype, fra og til, og sykmeldingsgrad |
| Prosjekter | Prosjektnummer, navn, kunde og om prosjektet er aktivt |
Fødselsnummer, fødselsdato, adresse, lønn og kontonummer sendes aldri. Begrunnelsen på en fraværssøknad og notater på vakter sendes heller ikke. Vakter som ikke er publisert, er med bare som godkjente timer.
Hvordan lager jeg en nøkkel?
Du må være administrator. Åpne Innstillinger → Tilgang og historikk → API.
- Skriv et navn, for eksempel systemet som skal bruke nøkkelen.
- Kryss av for det systemet trenger, og ikke mer.
- Trykk Lag nøkkel.
- Kopier nøkkelen og gi den til den som setter opp systemet.
Nøkkelen vises bare denne ene gangen. Timefly lagrer den ikke i lesbar form, så heller ikke vi kan finne den igjen. Har den kommet bort, trekker du den tilbake og lager en ny.
Hvordan stopper jeg en nøkkel?
Trykk Trekk tilbake ved nøkkelen og bekreft. Systemet mister tilgangen med en gang. Listen viser hvem som laget nøkkelen og når, når den sist ble brukt, og hvem som trakk den tilbake.
For den som setter opp systemet
Adressen er https://app.timefly.no/api/public/v1/, og nøkkelen sendes som Authorization: Bearer <nøkkel>. Hver nøkkel kan gjøre 120 kall i minuttet. Vakter, timer og fravær hentes for høyst 93 dager per kall. Den fullstendige beskrivelsen, med alle felt, er OpenAPI-filen docs/api/public-v1.yaml. Be om den hos Timefly.
Fant du ikke svaret? Skriv til oss.