Lær hvordan du oppretter API-nøkler og genererer tilgangstokens for Simployers API-er med SimplAuth.

SimplAuth er autentiseringsprotokollen som brukes for å få tilgang til Simployers API-er.

Forutsetninger for å bruke SimplAuth

For å bruke SimplAuth må du:

1. Være systemadministrator i Simployer-tenanten din. Hvis du ikke er systemadministrator, må du kontakte en eksisterende systemadministrator for å få denne rollen.
2. Ha tilgang til Simployer Admin Center, der du oppretter identifikasjonsdetaljer (credentials) som brukes til å generere tokens med SimplAuth. Hvis du er systemadministrator, oppretter du en supportsak hos Simployer Customer Care for å be om tilgang til Admin Center. Når du har fått tilgang, finner du Admin Center i Global Menu i Simployer Portal. Admin Center er gratis å bruke.

Opprett API-nøkler for SimplAuth

Du må være autentisert før du kan hente data fra Simployers API-er. Autentiseringen bruker tilgangstokens (access tokens) som genereres ved hjelp av API-nøkler.

1. Gå til Admin Center for å opprette en API-klient.
2. Gi klienten et navn, og velg hvilket API du vil ha tilgang til.
3. Opprett en hemmelig nøkkel (secret) for klienten.
4. Kopier den hemmelige nøkkelen, og lagre den på et sikkert sted. Du kan bare kopiere nøkkelen til utklippstavlen én gang. Ikke del nøkkelen med noen. Den er din private nøkkel til alle kjernedata i Simployer-tenanten din.
5. Gå til Quickstart-fanen, som er den første fanen øverst til venstre. Velg ønsket API, og lim inn den hemmelige nøkkelen i feltet. Velg cURL eller PowerShell, og kopier hele seksjonen.
6. Kjør cURL-kommandoen i et verktøy som Postman for å hente et JWT-token (access token).

Bruk tilgangstokenet fra SimplAuth

Bruk tilgangstokenet fra SimplAuth til å hente data fra API-et. Tokenet er gyldig i én time. Etter én time må du kjøre cURL-kommandoen på nytt for å hente et nytt token.