REST forespørsler mot åpne API-endepunkter
Hvordan bruke Postman til å utføre REST-forespørsler mot de åpne Altinn API-endepunktene, som ikke krever autentisering eller API-nøkler.
REST forespørsler som ikke krever API-nøkkel eller autentisering
De aller fleste API-endepunktene for Altinn krever både API-nøkkel og autentisering, men Metadata er åpne endepunkt som ikke krever noe.
For å vise hvordan man kan kalle disse fra Postman skal vi bruke GET /api/metadata
som returnerer informasjon om tjenestene i Altinn.
For referanseinformasjon om endepunktet kan man se på API Help for GET metadata eller Swagger for GET metadata.
Observer at URL er satt til {{envUrl}}/api/metadata
. Hvis Environmentet er satt opp korrekt, dvs. til TT02 for denne leksjonen, så vil envUrl
variabelen bli erstattet med https://tt02.altinn.no
når forepørselen sendes.
Følgende steg må følges for å sende forespørselen:
- I Params fanen:
- Slå av
language
parameteret, eller sett verdien til1033
,1044
, eller2068
. Dette tilsvarer Engelsk (Default), Bokmål, eller Nynorsk. Dette parameteret styrer språket til tekstverdiene som blir returnert.
- Slå av
- I Headers fanen:
- Slå av
ApiKey
. - Sett
Accept
tilapplication/hal+json
. Denne headeren beskriver formatet vi forventer i svaret. Content-Type
har ingen effekt på denne forespørselen.
- Slå av
- Trykk på Send.
Nå skal man få et svar som har statuskode 200 OK
. Dette betyr at forespørselen ble mottatt og besvart på en vellykket måte.
I Body på svaret kan man se all tjenestemetadata for alle tjenestene i TT02.
Siden det er ganske mange tjenester kan det ta noen sekunder før visningen får formatert JSON-formatet på en leselig måte.