Skip to main content

Feilsøking for integratorer

Når en integrasjon feiler, er det sjelden nok å vite at et kall gikk galt. Du trenger en strukturert måte å finne ut om problemet ligger i autentisering, data, mapping eller arbeidsflyt.

Start med disse fire spørsmålene​

  1. Er du autentisert med riktig type tilgang?
  2. Jobber du mot riktig organisasjon og miljø?
  3. Er dataene komplette og gyldige?
  4. Er utfallet du ser faktisk forventet ut fra arbeidsflyten?

Vanlige feiltyper​

Innlogging eller tilgang feiler​

  • kontroller credentials, miljø og scopes
  • sjekk at brukeren eller organisasjonen faktisk har tilgang
  • verifiser at du ikke bruker feil autentiseringsmodell

Rapporten fikk uventet status​

  • sjekk om organisasjonen bruker flows eller review-basert godkjenning
  • les rapporten tilbake etter mutasjonen
  • kontroller om nødvendige felter eller vedlegg manglet

Eksporten ser feil ut​

  • kontroller kategorier, kontokoder og satser
  • sjekk prosjekt- og avdelingsmapping
  • verifiser om samme objekt blir splittet i flere linjer

Varsler eller lenker peker feil​

  • sjekk hvilken type objekt lenken skulle åpne
  • kontroller at brukeren faktisk har tilgang til målet
  • verifiser at du bruker riktig ruteformat

Hva du bør logge​

  • tidspunkt
  • organisasjon eller kontekst
  • request-id, korrelasjons-ID eller annen sporingsnøkkel
  • payload inn og ut, med hemmeligheter maskert
  • hvilket utfall brukeren faktisk så

Før du ber om hjelp​

  • dokumenter hva du forsøkte å gjøre
  • legg ved et konkret eksempel på objekt eller payload
  • noter om feilen gjelder alle eller bare noen organisasjoner
  • beskriv forventet utfall, ikke bare at det ikke virker

Se også​

Nerdehjørnet

Praktisk tips: Lag en minimal reproduksjon du kan lime inn i en sak eller kjøre på nytt lokalt.

curl -i "$URL" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-Correlation-Id: debug-123" \
  -H "Accept: application/json"

God feilsøking handler først og fremst om å forstå domenet du er i. De vanligste feilene skyldes feil autentisering, misforstått statusflyt, mangelfull mapping eller antakelser om at ett API-kall alltid gir ett bestemt utfall. God logging og tydelig modellering sparer mye tid.