Responskoder

Response codes

Følgende http-koder returneres av rest-api-et:

The Digipost api can return the following http response codes:

• 200 OK
• 201 Created – En (forsendelses)ressurs har blitt opprettet på sørveren.
• 400 Bad Request – Kan bety:
  • En av de påkrevde headerne mangler.
  • Hashen angitt i X-Content-SHA256 eller Content MD5-headeren matcher ikke innholdet i meldingen (Content MD5 kan utelates).
  • Datoen angitt i headeren følger ikke det riktige formatet eller avviker fra sørverens systemklokke med mer enn fem minutter.
  • Emnet er blankt.
  • Forsendelses-id-en du angir, har blitt brukt før.
  • Brevet som lastes opp, har en filtype som ikke er støttet.
  • xml-en du sendte inn, er ugyldig i henhold til xsd-en.
• 403 Forbidden – Kan bety:
  • Du har ikke lastet opp et sertifikat for virksomheten din.
  • Signaturen er uriktig.
  • Du ber om en ressurs du ikke har tilgang til.
• 404 Not Found – Dersom du forsøker å opprette en forsendelse, betyr dette at den angitte mottakeren ikke er Digipost-bruker eller har deaktivert kontoen sin. Ellers er det en vanlig «not found»-feil.
• 409 Conflict – Du forsøker å laste opp et brev uten at forsendelsesstatusen er NOT_COMPLETE.
• 500 Internal Server Error – Det er en feil på vår side.

• 200 OK
• 201 Created – A (message) resource has been created on the server-side.
• 400 Bad Request – This can mean:
  • One of the required headers is missing.
  • This X-Content-SHA256 hash in the header does not match the content of the request.
  • The date specified in the header is not in the correct format or the date specified deviates from the date/time on the Digipost server by more than five minutes.
  • Subject is blank.
  • The message-id has been previously used.
  • The document/file type is not supported.
  • The xml does not validate according to the xsd.
• 403 Forbidden – This can mean:
  • You have not uploaded a certificate for your organisation.
  • The signature is incorrect.
  • You are not authorized to access the requested resource.
• 404 Not Found – If you are trying to create a message resource, this means the person you wish to send to is not a Digipost user or has deactivated their Digipost account. Otherwise, it is a normal «not found» error.
• 409 Conflict – You have attempted to send the actual file content even though the message status is not NOT_COMPLETE.
• 500 Internal Server Error – This is an error in the Digipost solution.

De fleste feilmeldinger fra sørveren vil gi gode forklaringer på hva problemet skyldes. Les derfor feilmeldingene du får tilbake fra api-et. Vi anbefaler også at du logger alle feilmeldinger du mottar, slik at det blir lettere for deg å debugge eventuelle problemer.

Most messages from Digipost with include an explanation of the error that occurred. It is therefore very helpful to read these error descriptions. We recommend that you log the error messages that you receive, since this will make troubleshooting much less painful.