Denne guide forklarer, hvordan du søger om en forbindelse til et af Danmarks Miljøportals API’er (programmeringsgrænseflader). Med denne forbindelse kan dit eget system eller en leverandørs system automatisk hente eller indberette data.
Guiden henvender sig til organisationer og deres it-leverandører, som vil bygge en integration til et af Danmarks Miljøportals systemer. Hvis du ikke selv har det kendskab, kan din it-leverandør søge på jeres vegne.
Trin for trin-guide
1. Hvad skal forbindelsen bruges til?
Hvilket system skal du have forbindelse til?
Skal du hente data ud af systemet, indberette data til systemet eller begge dele?
Skal din organisation selv bruge forbindelsen, eller er det en leverandør, der arbejder på jeres vegne?
Hvis du kun skal hente data ud, kan du måske klare dig uden en API-forbindelse. Undersøg først, om dataene allerede kan hentes i fx Naturdata eller Kemidata.
Hvis du skal indberette data, kræver det en dataleverance- eller databehandleraftale med Danmarks Miljøportal.
2. Forbindelsestyper
Der findes to forbindelsestyper:
- Client Credentials: Dit system logger selv på med et Client ID og et Client Secret.
- Code Flow: Brugeren logger ind med sin egen bruger og giver jeres applikation lov til at hente data på brugerens vegne.
| System | Forbindelsestype |
| Arealeditering | Code Flow |
| Brugerstyring | Client Credentials |
| DK Jord | Client Credentials |
| EA-Tools | Client Credentials og Code Flow |
| Naturdatabasen | Code Flow |
| Non-Target | Client Credentials |
| PULS | Client Credentials |
| Rotter | Code Flow |
| Stanlab | Client Credentials |
| VanDa Hydro |
Du finder den tekniske dokumentation for hvert API på Danmarks Miljøportals side på GitHub.
3. Oplysninger der behøves
Client Credentials forbindelse
| Oplysning | Beskrivelse |
| Navn på organisationen | Navnet på den organisation der skal bruge forbindelsen |
| CVR | CVR på den organisation der skal bruge forbindelsen |
| System | Hvilket system skal der forbindes til |
| Roller | Hvilke roller er nødvendige for at organisationen kan udføre deres opgave |
| Kontaktperson | Navn og en e-mailadresse til en kontaktperson hos organisationen der skal bruge forbindelsen. |
| Link til GitHub | Linket til dokumentationen for API’et |
Code flow forbindelse
| Oplysning | Beskrivelse |
| System | Hvilket system skal der forbindes til |
| Roller | Hvilke roller er nødvendige for at organisationen kan udføre deres opgave |
| Authorization Endpoint | URL’en til tjenesten, hvor brugeren giver tilladelse til jeres applikation |
| Token Endpoint | URL’en til tjenesten hvor jeres applikation vil bytte autorisationskode til adgangstoken |
| Redirect URL | URL’en til den applikation, hvor jeres bruger vil blive sendt til efter givet tilladelse |
| Link til GitHub | Linket til dokumentationen for API’et |
4. Send din ansøgning med oplysninger fra trin 3 til Danmarks Miljøportal support.
Supporten kontakter dig, hvis vi mangler oplysninger. Hvis din organisation ikke allerede er oprettet hos Danmarks Miljøportal, skal I skrive under på en brugerstyringsaftale og vælge, hvordan jeres brugere skal logge ind. Når forbindelsen er klar, får du dine adgangsoplysninger.
Kommentarer
0 kommentarer
Artiklen er lukket for kommentarer.