Udvikling - Arealeditering: Editeringsservice - Information om Editservice (REST API)

Denne artikel er beregnet til udvikler af 3. partssystemer, som benytter editservicen til Arealeditering (Danmarks Arealinformation). 

I denne artikel findes en række informationer og dokumentationsmateriale angående denne service.

1) 

Linket til den REST-baserede DAI editservice i DEMO-miljø:

https://arealeditering-api.demo.miljoeportal.dk/

Dokumentation i form af endpoints, inputparametre samt eksempler på request og response er tilgængelige via et online værktøj, Swagger. Swagger kan også anvendes som online testklient

https://arealeditering-api.demo.miljoeportal.dk/swagger/index.html.

2)

Der findes en eksempel testklient skrevet i c#, som kan benyttes til at teste op imod servicen. Denne testklient kan hentes og installeres ved at åbne den vedhæftede zipfil (se nederst i denne artikel). 

Testklienten er en .NET Core konsolapplikation, og anvender OpenID Connect til at forbinde til Danmarks Miljøportals brugerstyring.
Formålet med klienten er, at demonstrere hvordan den REST-baserede webservice kan tilgås fra en klient, samt at demonstrere hvordan der kan udføres brugerstyret login.

Vær i forbindelse med integration til services opmærksom på flg.:  

• Testklienten er ikke altid opdateret med nyeste version ændringer. Her henvises til Swagger for DEMO-miljøet i stedet for. 
• Request /Response via. JSON jf. https://jsonapi.org/ (RFC 7159, https://jsonapi.org/format/, MIME: application /vnd.api+json )
• Geometrier i request /response jf. GeoJson specifikation (RFC 7946, https://geojson.org/) med dansk koordinatsystem EPSG:25832
• OpenID Connect (OAuth2) Code flow (dvs. SAML2 udfases)

3) 

Datamodellen for alle temaer, i Arealeditering findes på Danmarks Miljøportals hjemmeside.