API - Adgang

Formål

Du kan via denne vejledning se, hvad der skal til for at få adgang til API'et til DitmerFlex.

Forudsætning

• Du skal have opsat et API til DitmerFlex
• Du skal have lavet en DNS registrering til API'et

Vejledning

For at få adgang til api'et kræver der at man sender en header ved navn "publicApiToken" med alle sine kald som indeholder en token fra DitmerFlex.

På nuværende tidspunkt er det kun muligt at trække denne token igennem en API brugerimport som beskrevet i nedenstående afsnit. Dette er kun en midlertidig løsning og måden at administrere tokens på vil blive ændret på sigt.

Opret token via API brugerimport

Du opretter selve brugerimporten inde i DitmerFlex i administrationsdelen på menupunktet "API Brugerimport" ved at klikke på "Opret ny"

Når du opretter brugerimporten vil adressen til API'et automatisk blive vist i brugergrænsefladen, og du vil få et token, som du kan bruge til at logge på API'et med.

Det er derfor vigtigt, at du gemmer det token, som der også står i oprettelsesbilledet

Du kan naturligvis altid hente et nyt token via brugergrænsefladen i DitmerFlex ved at vælge "Opsætning" på din brugerimport.

Og herunder klikke på "Generer nyt token"'. Gør du dette vil det gamle token ikke virke mere.

Eksempel

Med dette token vil man nu være i stand til at kalde alle kald på api'et. Nedenstående viser et PowerShell script der kalder api'et hvor headeren er sat.

Invoke-RestMethod -Method 'Get' -Headers @{'Content-Type'='application/json';'publicApiToken'='InsertDitmerFlexTokenHere'} -Uri 'https://api.InsertDitmerFlexUrlHere/PATH'