API-autentisering

Sirktek API bruker OAuth2 Client Credentials flow for maskin-til-maskin autentisering.

API-dokumentasjon

REST API-et er dokumentert med OpenAPI/Swagger pÄ: https://test-api.sirktek.com/assets/v1/q/swagger-ui/

Oppsett av autentiseringslient

For Ă„ fĂ„ tilgang til API-et mĂ„ du sette opp en autentiseringsklient. Kontakt [email protected] for Ă„ fĂ„ opprettet en klient.

Du vil motta:

  • Client ID: Unik identifikator for din applikasjon
  • Client Secret: Hemmelig nĂžkkel for autentisering

Autentiseringsprosess

1. Hente tilgangstoken

Utveksle client_id og client_secret mot et tilgangstoken ved Ă„ sende en HTTP POST-forespĂžrsel:

curl --request POST \
  --url https://test-auth.sirktek.com/oauth/token \
  --header 'content-type: application/json' \
  --data '{
    "client_id": "<din client id>",
    "client_secret": "<din client secret>",
    "audience": "<audience>",
    "grant_type": "client_credentials"
  }'

2. Token-respons

API-et returnerer et tilgangstoken som er gyldig i 86 400 sekunder (24 timer).

Viktig: Lagre og gjenbruk tokenet til det utlÞper for Ä unngÄ unÞdvendige autentiseringsforespÞrsler.

3. Bruke tokenet i API-kall

Inkluder tokenet i Authorization-headeren for alle API-forespĂžrsler:

curl --request GET \
  --url https://test-api.sirktek.com/api/endpoint \
  --header 'authorization: Bearer <ditt tilgangstoken>'

Sikkerhet

  • Aldri del din client secret eller tilgangstokener
  • Lagre legitimasjoner sikkert i miljĂžvariabler eller en sikker konfigurasjonsfil
  • Implementer automatisk token-fornyelse nĂ„r tokenet nĂŠrmer seg utlĂžp