API-referanse
Laste opp binærdata
Laster opp et binært objekt og responderer med en id som deretter kan brukes som referanse i et endringssett.
Mønster
POST /rest/v3/binaer
Request
Hode
| Navn | Type | Beskrivelse |
|---|---|---|
| Content-Type | MediaType | Angir media-type for payload, f.eks. image/png |
| Content-Disposition | Tekst | Hvis en ønsker å angi et filnavn for egen referanse, f.eks. filename="N808080-1.png" |
| Authorization | Autentiseringstoken | Bearer med id-token fra OpenId Connect. |
| X-Client | Tekst | Angir navnet på klientapplikasjonen. |
| X-Request-ID | UUID | Angir unik korrelasjonsidentifikator for requesten. |
Payload
Binærdata.
Eksempel
POST /rest/v3/binaer HTTP/1.1
Content-Type: image/png
Content-Disposition: filename="N808080-1.png"
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJraWQiOiJrV3Y5elBvNUdsUUxqam1CTkdHQW1hMmtRMmM9IiwiYWxnIjoiUlMyNTYifQ...
X-Client: MinKlientApplikasjon
X-Request-ID: edf1f9eb-38dd-46e3-a250-52b810277b18
.PNG........IHDR.............:~.U....IDATx.cj.......U.o....IEND.B`.
Respons
Hode
| Navn | Type | Beskrivelse |
|---|---|---|
| Location | URI | Angir hvor binærobjektet kan hentes. |
Payload
UUID for det registrerte binærobjektet formatert som JSON-streng.
Eksempel
HTTP/1.1 201 Created
Content-Type: application/json; charset=UTF-8
Location: https://nvdbapiskriv.atlas.vegvesen.no/rest/v3/binaer/12d57307-8ba8-4866-8373-153768cfbd09
"12d57307-8ba8-4866-8373-153768cfbd09"
Laste opp binærdata fra nettside
Et binært objekt kan lastes opp via filopplasting fra en nettside med følgende HTML-fragment:
<form method="post" action="/rest/v3/binaer" enctype="multipart/form-data">
<!-- Viktig: name="content" -->
<input type="file" name="content"/>
<input type="submit"/>
</form>
Laste ned binærdata
Tillater nedlasting av tidligere opplastede binærdata.
Mønster
GET /rest/v3/binaer/{id}
Request
Hode
| Navn | Type | Beskrivelse |
|---|---|---|
| Authorization | Autentiseringstoken | Bearer med id-token fra OpenId Connect. |
| X-Client | Tekst | Angir navnet på klientapplikasjonen. |
| X-Request-ID | UUID | Angir unik korrelasjonsidentifikator for requesten. |
Eksempel
GET /rest/v3/binaer/12d57307-8ba8-4866-8373-153768cfbd09 HTTP/1.1
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJraWQiOiJrV3Y5elBvNUdsUUxqam1CTkdHQW1hMmtRMmM9IiwiYWxnIjoiUlMyNTYifQ...
X-Client: MinKlientApplikasjon
X-Request-ID: edf1f9eb-38dd-46e3-a250-52b810277b18
Respons
Hode
| Navn | Type | Beskrivelse |
|---|---|---|
| Content-Type | MediaType | Samme verdi som angitt ved opplasting. |
| Content-Disposition | Tekst | Samme verdi som angitt ved opplasting. |
Payload
Binærdata.
Eksempel
HTTP/1.1 200 OK
Content-Type: image/png
Content-Disposition: filename="N808080-1.png"
.PNG........IHDR.............:~.U....IDATx.cj.......U.o....IEND.B`.