Feilkoder

Referanse for Altinn Notifications API feilkoder

Denne siden gir en omfattende referanse for alle spesifikke feilkoder som returneres av Altinn Notifications API.

Feilkodeformat

Altinn Notifications API bruker unike feilkoder i formatet NOT-XXXXX hvor NOT står for Notifications og XXXXX er et femsifret nummer.

Disse feilkodene returneres i code-feltet i problemdetaljrespons. code-feltet er et utvidelsesmedlem som definert av RFC 7807 (Problem Details for HTTP APIs), som gir maskinlesbar feilidentifikasjon.

Feilkoder

NOT-00001: Manglende kontaktinformasjon

HTTP-statuskode: 422 Unprocessable Entity

Beskrivelse: API-et kunne ikke behandle varslingsordren fordi én eller flere mottakere ikke har nødvendig kontaktinformasjon tilgjengelig for Altinn.

Vanlige årsaker:

• Mottakeren har ikke registrert en e-postadresse eller et telefonnummer
• Mottaker har registrert kontaktinformasjon, men den er ikke gyldig eller verifisert
• For organisasjonsmottakere kan det hende at organisasjonen ikke har registrert kontaktdetaljer

Berørte endepunkter:

• POST /future/orders - Oppretting av varslingordrer med mottakeroppslag

Eksempelrespons:

{
  "status": 422,
  "code": "NOT-00001",
  "detail": "Missing contact information for recipient(s)"
}

Løsning:

• Verifiser at mottakerens fødselsnummer eller organisasjonsnummer er riktig
• Be mottakeren registrere sin kontaktinformasjon for å gjøre den tilgjengelig for Altinn
• For umiddelbare varsler, vurder å bruke de direkte emailAddress- eller phoneNumber-feltene i stedet for å stole på mottakeroppslag

NOT-00002: Forespørsel avbrutt av klient

HTTP-statuskode: 499 Client Closed Request

Beskrivelse: Klienten koblet fra eller kansellerte forespørselen før serveren kunne fullføre behandlingen. Dette er en ikke-standard HTTP-statuskode (499) som ofte brukes for å indikere at klienten lukket tilkoblingen for tidlig.

Vanlige årsaker:

• Timeout på klientsiden oppstod
• Nettverkstilkoblingen ble avbrutt
• Bruker kansellerte operasjonen
• Applikasjonen avsluttet HTTP-forespørselen

Berørte endepunkter:

• Alle API-endepunkter (ethvert endepunkt kan motta denne feilen hvis klienten kobler fra)

Eksempelrespons:

{
  "status": 499,
  "code": "NOT-00002",
  "detail": "The client disconnected or cancelled the request before the server could complete processing"
}

Løsning:

Hvis du får mange timeouts og lignende typer feil:

• Øk timeout-innstillingen i HTTP-klienten din
• Sjekk nettverkstilkobling og stabilitet
• Implementer retry-logikk ved å bruke samme idempotencyId for å trygt prøve forespørselen på nytt
• Hvis problemet vedvarer, kontakt Altinn support

NOT-00003: Forsendelse ikke funnet

HTTP-statuskode: 404 Not Found

Beskrivelse: Den forespurte forsendelsen (varslingordre) ble ikke funnet. Dette kan oppstå når forsendelses-ID-en ikke eksisterer eller når den forespørrende organisasjonen ikke har tilgang til forsendelsen.

Vanlige årsaker:

• Forsendelses-ID-en (GUID) eksisterer ikke i systemet
• Forsendelsen ble opprettet av en annen organisasjon
• Forsendelses-ID-en er feilformatert eller ugyldig
• Forsendelsen kan ha blitt opprettet i et annet miljø (f.eks. test vs. produksjon)

Berørte endepunkter:

• GET /future/shipment/{id} - Henting av leveringsmanifest for en varslingordre

Eksempelrespons:

{
  "status": 404,
  "code": "NOT-00003",
  "detail": "Shipment not found"
}

Løsning:

• Verifiser at forsendelses-ID-en er korrekt og riktig formatert som en GUID
• Forsikre deg om at du spør i riktig miljø (test eller produksjon)
• Verifiser at den autentiserte organisasjonen har tilgang til forsendelsen
• Sjekk at forsendelsen ble vellykket opprettet før du prøver å hente den

Generelle HTTP-statuskoder

I tillegg til de spesifikke feilkodene ovenfor returnerer API-et også standard HTTP-statuskoder:

Relaterte ressurser

• Veiledning for umiddelbare varsler
• Altinn Notifications API-referanse
• OpenAPI-spesifikasjon