Begreb Kald, kvoter og nøgler · Grundfast

# Testnøgle

En testnøgle er en API-nøgle, der begynder med gf_test_. Den rammer de samme rigtige registre som en live-nøgle (gf_live_), men faktureres aldrig og tæller ikke mod planens kvote.

Også kaldt: gf_test_, gf_live_, Live-nøgle, Sandbox-nøgle, API-nøgle

## To slags nøgler

Alle data-endpoints kræver en API-nøgle i `Authorization`-headeren som `Bearer`. Der findes to slags. En live-nøgle, `gf_live_…`, er til produktion: kaldene tæller mod planens [månedskvote](https://grundfast.dk/begreber/maanedskvote), og overforbrug faktureres på de betalte planer. En testnøgle, `gf_test_…`, er til udvikling, CI og staging: den giver de samme rigtige data, men kaldene faktureres aldrig.

Testnøglen er ikke en demo med opdigtede svar. Det er de samme registre og det samme svar, så en parser, der virker mod en testnøgle, virker også i produktion. Til gengæld har testnøgler deres eget loft på 25.000 kald pr. måned, uanset plan, og samme burst-grænse som planen. Ved loftet svarer API’et `429` med besked om at bruge en live-nøgle i produktion.

## Sådan kender du forskel

Præfikset står i selve nøglen, og hvert svar bærer headeren `X-Grundfast-Environment` med værdien `live` eller `test`. Log headeren i din integration, så du kan se, hvilken nøgle et miljø faktisk kører med.

## Det skal du vide som udvikler

- **Nøglen vises kun én gang.** Den oprettes i dashboardet, og vi gemmer kun en hash af den. Kopiér den med det samme.
- **Hold nøglen på serveren.** En nøgle i browserkode kan læses af alle; lad din backend kalde API’et.
- **Én nøgle pr. miljø.** Giv CI, staging og produktion hver sin nøgle, så du kan tilbagekalde netop den, der er sluppet ud.
- **Testnøgler kan altid oprettes.** Oprettelse af en live-nøgle kan kræve, at din e-mailadresse er bekræftet.

Kan du ikke sætte en header — fx i et kortbibliotek, der selv henter tiles — kan nøglen sendes som `?token=`. En URL havner i logs og historik, så giv en sådan URL sin egen nøgle. Detaljerne står i [Godkendelse og nøgler](https://grundfast.dk/docs/godkendelse).

## I API’et

- [Live- og testnøgler](https://grundfast.dk/docs/godkendelse)
- [Opret en nøgle og lav det første kald](https://grundfast.dk/docs/kom-i-gang)
- [Testnøglens loft](https://grundfast.dk/docs/rate-limits)

## Slå det op på en rigtig ejendom

Med en gratis nøgle får du begrebet som felt i svaret — oversat, med WGS84-geometri og på tværs af registrene med samme BFE-nummer.

[Kom i gang gratis](https://grundfast.dk/dashboard?mode=register) [Alle begreber](https://grundfast.dk/begreber)

Gratis op til 5.000 kald/md · intet kreditkort · data fra Klimadatastyrelsen/Datafordeler, CC BY 4.0

Relaterede begreber

- [Kald Et kald er den enhed, Grundfast måler forbrug i: ét opslag mod API’et, der lykkes, er ét kald. Planernes kvoter og prisen for overforbrug er angivet i kald.](https://grundfast.dk/begreber/kald)
- [Månedskvote Månedskvoten er det antal kald, en plan indeholder pr. kalendermåned. Den nulstilles den 1. i måneden kl. 00:00 UTC, og forbrug over den afregnes som overforbrug på de betalte planer.](https://grundfast.dk/begreber/maanedskvote)