Opret nøgle

For at kunne bruge EventTilmeldings API skal du have en gyldig API nøgle.

Du opretter en nøgle i dine API indstillinger, som kan findes i menuen i højre hjørne (når du klikke på dit profilbillede), under menu punktet API indstillinger.

Inde i dine API indstillinger kan du trykke på knappen Få en ny nøgle, og give din nøgle et navn, så du kan huske hvad den er til. Senere vil nøgler have specifikke områder de kan interagere med API'en.

Når du opretter en nøgle vil du kunne se at den har et ID, som står under det navn du gav den, og selve nøglen. Nøglens værdi vil kun være synlig lige efter du opretter den, så vi anbefaler at du skriver den ned et sikkert sted.

Praktisk info

Nøglen tilhører din bruger, og hvis andre får adgang til den kan de bruge API'en på dine vegne, så sørg for at den er gemt sikkert.

Vi kører din nøgle gennem en hashfunktion før vi gemmer den, så vi kan ikke hjælpe dig med at få din nøgle hvis du har glemt den.

Hvis du har mistet din nøgle, eller mistænker at andre har fået adgang til, kan du slette nøglen i dine API indstillinger, og derefter oprette en ny nøgle. Husk at brug den nye nøgle de steder du brugte den gamle.

Authorization

For at kunne få adgang til EventTilmeldings API, skal du have en API nøgle med i alle dine requests.

Nøglen skal være i en header der hedder Authorization.

Du skal bruge din nøgles ID og dens værdi. Værdien burde du have gemt et sikkert sted, og ID'et kan findes under din liste af API nøgler.

Når du har din nøgle skal du encode den i Base64. Det du skal encode er {keyId}:{keyValue}, eksempel myKeyId123:myKeyValue123. Derefter skal du sætte den encoded værdi i din Authorization header med værdien Authorization: Basic encodedKeyIdValuePair.

Start URI'en for alle API'erne er https://eventtilmelding.dk/api/v1. I siderne for hver API skriver vi kun det du skal sætte efter base URI'en.

Du er nu klar til bruge de forskellige API'er.