Request-eksempler

Eksempler på hvordan man henter data om en gitt virksomhet

Generelt

Tilda er tilgjengelig i to miljøer - test.data.altinn.no og data.altinn.no. Man må be om API-nøkkel for produktet “Tilsynsdata” begge steder.

Kallene autentiseres med et token fra Maskinporten med scopet altinn:dataaltinnno/tilda (i testmiljøet fra test.maskinporten.no).

1. Bruker i Samarbeidsportalen. Registrer deg på samarbeid.digdir.no med jobb-e-posten din; du knyttes til virksomheten gjennom e-postdomenet. Virksomheten må ha signert Digdirs bruksvilkår (gjøres én gang, av en som kan forplikte virksomheten).
2. Rettighet i Altinn. For å opprette og administrere integrasjoner trenger du rettigheten «Selvbetjening av klienter i ID-porten/Maskinporten» (test og produksjon) eller «Selvbetjening for testing» (kun test). Den delegeres av virksomhetens hovedadministrator i Altinn.
3. Opprett integrasjonen. I Samarbeidsportalen: Virksomhetens tjenester → Administrasjon av tjenester → Integrasjoner → Ny integrasjon, av typen Maskinporten. Test og produksjon er adskilte miljøer; start i test. Du trenger ikke virksomhetssertifikat: et eget asymmetrisk nøkkelpar er nok (den offentlige nøkkelen legges inn som JWK). Har dere allerede virksomhetssertifikat, kan det brukes i stedet. Se Selvbetjening via Samarbeidsportalen.
4. Få tildelt scope. Scopet tildeles alle Tilda-konsumenter i både test og produksjon. Du legger det på integrasjonen din selv; mangler det for din virksomhet, ta kontakt på dan@altinn.no.
5. Hent token og kall API-et. Signer et JWT-grant med nøkkelen og send det til Maskinportens token-endepunkt (test, produksjon). Bruk access_token som Authorization: Bearer sammen med API-nøkkelen for produktet Tilsynsdata (Ocp-apim-subscription-key) fra utviklerportalen i samme miljø: test.data.altinn.no for test, data.altinn.no for produksjon. Nøklene er ikke de samme i de to miljøene. Framgangsmåten steg for steg står i Digdirs veiledning for API-konsumenter.

For mer informasjon om API-ene i data.altinn.no, se Kom i gang med API.

Alle kall til data.altinn.no må ha følgende headere:

Authorization med bearertoken fra maskinporten

Ocp-apim-subscription-key med API-nøkkel fra valgt miljø

Kalle på Tilda-apiet

For eksempler på hvordan man kaller Tilda kan man se på hvert element i datasettoversikten.

Vi anbefaler bruk av “direktehøsting”.