Feilsøking for utviklere
Finn ut om problemet ligger i autentisering, data, mapping eller arbeidsflyt.
Start med disse fire spørsmålene
- Er du autentisert med riktig type tilgang?
- Jobber du mot riktig organisasjon og miljø?
- Er dataene komplette og gyldige?
- 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 flyt eller vurderingsbasert 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
Lag en minimal reproduksjon du kan lime inn i en sak eller kjøre på nytt lokalt. Bruk -i for å få med responseheadere, og noter eventId fra body hvis det er en intern feil.
curl -i "$URL" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json"
Merk: API-et emitterer ikke en standard x-request-id eller tracing-header i dag – det mest presise sporet er eventId i feilresponsens body (når satt). correlationId er et body-felt på enkelte upload-endepunkter for å koble vedlegg til samme capture-økt, ikke en tracing-ID.