POST /api/{tenant}/arkivmelding

Mottar en KS/Noark-arkivmelding som ZIP i multipart/related.

Description

Brukes når ZIP-pakken inneholder arkivmelding-XML (standardfil arkivmelding.xml, eller MetadataFilnavn på avsenderen). JSON-manifestet må være første multipart-del med type arkivmelding. ZIP-delen må ha Content-Id og filename som matcher files[]. XSD-validering styres av avsenderoppsettet. HTTP 201 betyr lagret i Mottak, ikke journalført i WebSak.

Parameters

Name In Description Required Type
tenant path API-nøkkel (GUID) tildelt avsenderen i Mottak+. Behandles som hemmelighet. Ugyldig eller inaktiv nøkkel gir HTTP 404. true string

Request body

Forespørselen er multipart/related, ikke JSON. Jekyll-REST-tabellen viser bare application/json, så den er tom her.

Rekkefølgen er påkrevd: JSON-manifest først, deretter ZIP.

  1. Content-Type på hele forespørselen: multipart/related; boundary=<unik-streng>.
  2. Første del: JSON med Content-Type: application/json.
  3. Andre del: ZIP med Content-Disposition: form-data; name="arkivmelding" eller name="melding", filename lik files[].filename, Content-Type: application/zip og Content-Id lik files[].contentid.

Parseren matcher ZIP mot manifestet på filnavn. Se Sende arkivmelding for feltliste og eksempler.

files[].hash er sjekksum av hele ZIP-filen, ikke av XML-innholdet alene. Sammenligningen er eksakt. Kundeksemplene bruker SHA256 som heksadesimal streng med store bokstaver. Feil hash gir HTTP 400 med tekst på formen <filnavn> bestod ikke hash validering.

Responses

Code Returns Type
201 Meldingen er mottatt og lagret som importobjekt i Mottak. Dette er ikke bekreftelse på at innholdet er journalført i WebSak. Acos.Mottaksenter.SkjemaWebService.Infrastructure.OpenApi.ArkivmeldingAcceptedFileDto
400 Ugyldig pakke. Hash som ikke stemmer returneres som ren tekst. XSD-feil og manglende fil i ZIP returneres som JSON med message, errors, warnings og fil. Acos.Mottaksenter.SkjemaWebService.Infrastructure.OpenApi.ArkivmeldingValidationErrorDto
404 Ukjent eller inaktiv tenant-nøkkel. Ruten matcher ikke.
422 Meldingen kunne ikke behandles. JSON-feltet heter message. Acos.Mottaksenter.SkjemaWebService.Infrastructure.OpenApi.ArkivmeldingUnprocessableErrorDto
500 Uventet feil, inkludert request som ikke er multipart. Kroppen er ProblemDetails. Microsoft.AspNetCore.Mvc.ProblemDetails
Response Example
{ 
        
        "contentid":"string",
        "filename":"string",
        "hash":"string",
        "alg":"string",
        "metadata":"boolean"
}

HTTP 201 Created betyr at importobjektet er lagret i Mottak. Kroppen er JSON for den mottatte filen, ikke saksnummer eller journalpostnummer fra WebSak.

Tjenesten har ingen unikhetssjekk på messageId. Retry kan gi duplikat. Se feilhåndtering og drift.