Hva er en API-nøkkel?
En API-nøkkel gir et eksternt system tilgang til dataene dine i Tripletex. Du bruker den til å bygge egne integrasjoner for internt bruk — for eksempel for å hente ut regnskapsdata til analyse, eller for å sende data inn i Tripletex automatisk. Disse nøklene er kun for egenutviklede løsninger til eget bruk. Skal du bygge en integrasjon du vil selge videre eller tilby andre, må du bruke en partnerintegrasjon i stedet.
Skal du koble et eget system til Tripletex, kan du opprette og administrere API-nøkler selv. Her viser vi deg hvordan du oppretter, redigerer og sletter nøkler på siden «API-nøkler».
Krav for å bruke denne siden:
- Tilleggstjenesten «Integrasjoner» må være aktivert i kontoen. Les mer om hvordan du aktiverer integrasjoner her.
- Du må være brukeradministrator.
Du finner siden ved å gå til Selskap > API-nøkler i hovedmenyen.
Oversikt over nøklene dine
I tabellen ser du alle API-nøklene som er opprettet i kontoen. Hver kolonne viser informasjon om nøkkelen:
| Kolonne | Beskrivelse |
| ID | Unikt nummer for nøkkelen |
| Navn | Navnet du ga nøkkelen ved opprettelse |
| Opprettet av | Hvem som opprettet nøkkelen |
| Opprettelsesdato | Når nøkkelen ble opprettet |
| Utløpsdato | Når nøkkelen slutter å være aktiv |
| Status | Om nøkkelen er «Aktiv», «Utløper snart» eller «Utløpt» |
Du kan filtrere listen med fanene «Alle», «Aktiv» eller «Utløpt», og søke etter en nøkkel i søkefeltet.
Slik oppretter du en API-nøkkel:
- Klikk på «Opprett nøkkel» oppe til høyre.
-
Fyll inn følgende:
– Nøkkelnavn: Gi nøkkelen et beskrivende navn, for eksempel navnet på systemet den skal brukes til.
– Teknisk kontakt-e-post: E-postadressen til personen som er teknisk ansvarlig for integrasjonen.
– Utløpsdato (valgfritt): Velg en dato dersom nøkkelen skal slutte å virke etter en viss tid. Lar du feltet stå tomt, er nøkkelen aktiv på ubestemt tid.
- Klikk på «Opprett nøkkel».
Nøkkelen vises nå i en dialog. Kopier nøkkelen ved å trykke på kopier-ikonet, og lagre den et trygt sted.
Viktig: Nøkkelen vises kun denne ene gangen og kan ikke hentes frem igjen senere. Sørg for å kopiere og lagre den før du lukker dialogen.
Klikk på «Ferdig» når du har opprettet nøkkelen.
Slik redigerer du en nøkkel:
- Finn nøkkelen i tabellen.
- Klikk på menyen (⋮) til høyre for nøkkelen.
- Velg «Rediger».
- Nå kan du oppdatere utløpsdato og endre brukertilgangene til nøkkelen. Merk at datoen ikke kan settes tilbake i tid.
Slik sletter du en nøkkel:
- Finn nøkkelen i tabellen.
- Klikk på menyen (⋮) til høyre for nøkkelen.
- Velg «Slett».
Merk: Når du sletter en nøkkel, mister integrasjonen som bruker den umiddelbart tilgangen til Tripletex. Forsikre deg om at nøkkelen ikke er i bruk før du sletter den.