API-dokumentation

Indhegn.dk API giver dig adgang til vores AI-drevne arealberegning direkte fra din egen hjemmeside eller applikation. Analyser enhver dansk adresse og få estimeret græsareal, havetype og adgangsforhold på sekunder.

Hvad kan API'et?

Med Indhegn API kan du:

• Analysere enhver dansk adresse og få estimeret græsareal i m²
• Modtage AI-vurderet havetype (Velplejet / Forsømt / Ingen plæne)
• Modtage adgangsforhold (God / Begrænset / Ukendt)
• Hente officielle BBR-data fra Datafordeleren
• Vise resultater direkte i din kontaktformular via iframe-widget

Base URL

https://www.indhegn.dk

Autentificering

Alle API-kald kræver en gyldig API-nøgle sendt som en HTTP-header.

Få en API-nøgle

API-nøgler uddeles manuelt. Kontakt os på kontakt@indhegn.dk for at komme i gang. Vi knytter nøglen til din eksisterende Indhegn-konto og opsætter de tilladte domæner.

Rate limiting

For at sikre stabil drift er der begrænsning på antallet af kald per API-nøgle.

Overskrides rate limit returneres HTTP 429 Too Many Requests. Vent 60 sekunder og prøv igen.

Fejlhåndtering

API'et returnerer standard HTTP-statuskoder og et JSON-objekt med en fejl-nøgle ved fejl.

// Eksempel på fejlsvar
{
  "fejl": "Rate limit overskredet. Maks 10 kald per minut."
}

POST /api/v1/beregn

Request body

Eksempel

POST /api/v1/beregn
X-API-Key: ink_din_noegle_her
Content-Type: application/json

{
  "adresse": "Strandvejen 4, 8000 Aarhus"
}

Svar-format

Ved succes returneres et JSON-objekt med følgende felter:

🤖 = AI-estimeret felt. Dobbelttjek altid vigtige estimater.

Eksempel på svar

{
  "adresse": "Strandvejen 4, 8000 Aarhus C",
  "matrikelnr": "12a",
  "lat": 56.1629,
  "lng": 10.2039,
  "grundareal": 420,
  "bygningsareal": 148,
  "graes_areal": 185,
  "graes_procent": 44,
  "ai_sikkerhed": 82,
  "havetype": "Forsømt",
  "adgang": "God",
  "byggeaar": 1962,
  "kommentar": "Parcelhus med stor, delvist forsømt have. God adgang via indkørsel."
}

Iframe-widget

Iframe-widgetten giver dine besøgende mulighed for at indtaste en adresse og se et Indhegn-estimat direkte på din hjemmeside – uden at de forlader siden.

Integrationskode

Indsæt følgende kode på din hjemmeside der hvor du vil vise widgetten:

<iframe
  src="https://www.indhegn.dk/widget?key=INK_DIN_NOEGLE_HER"
  width="100%"
  height="480"
  frameborder="0"
  style="border:none;border-radius:8px;box-shadow:0 2px 12px rgba(0,0,0,.1)">
</iframe>

Erstat INK_DIN_NOEGLE_HER med din API-nøgle.

Tilpasning af widget

Du kan tilpasse widgettens udseende via URL-parametre:

Eksempel med tilpasning

<iframe
  src="https://www.indhegn.dk/widget?key=ink_xxx&titel=Beregn%20din%20have&farve=2a4a8f&knaptekst=Se%20estimat"
  width="100%" height="480" frameborder="0">
</iframe>

Eksempel – JavaScript

Simpelt kald fra browser via en backend-proxy (anbefalet for at beskytte API-nøglen):

// FRONTEND: kald din egen backend
async function beregnHave(adresse) {
  const svar = await fetch("/din-backend/beregn", {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({ adresse })
  });
  return svar.json();
}

// BACKEND (Node.js eksempel):
app.post("/din-backend/beregn", async (req, res) => {
  const svar = await fetch("https://www.indhegn.dk/api/v1/beregn", {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "X-API-Key": process.env.INDHEGN_API_KEY
    },
    body: JSON.stringify({ adresse: req.body.adresse })
  });
  res.json(await svar.json());
});

Eksempel – PHP

<?php
function indhegn_beregn($adresse) {
  $ch = curl_init("https://www.indhegn.dk/api/v1/beregn");
  curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => [
      "Content-Type: application/json",
      "X-API-Key: " . getenv("INDHEGN_API_KEY")
    ],
    CURLOPT_POSTFIELDS => json_encode(["adresse" => $adresse])
  ]);
  $svar = curl_exec($ch);
  curl_close($ch);
  return json_decode($svar, true);
}

$data = indhegn_beregn("Strandvejen 4, 8000 Aarhus");
echo "Estimeret græsareal: " . $data["graes_areal"] . " m²";
?>

Eksempel – HTML kontaktformular

Fuld formular med adresse-autocomplete og live Indhegn-estimat:

<form id="tilbud-form">
  <input type="text" id="adresse-input"
    placeholder="Din adresse..."
    oninput="hentAutocomplete(this.value)" />
  <div id="estimat-resultat" style="display:none"></div>
  <button type="submit">Send tilbudsforespørgsel</button>
</form>

<script>
async function beregnAdresse(adresse) {
  const svar = await fetch("/api/beregn", {  // Din backend-proxy
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({ adresse })
  });
  const data = await svar.json();
  if (data.graes_areal) {
    document.getElementById("estimat-resultat").style.display = "block";
    document.getElementById("estimat-resultat").innerHTML =
      `Estimeret græsareal: <strong>${data.graes_areal} m²</strong> ·
       Havetype: <strong>${data.havetype || "–"}</strong>`;
  }
}
</script>

Kontakt & priser

API-adgang er ikke en selvbetjeningsydelse endnu. Kontakt os for at komme i gang:

Priser for API-adgang aftales individuelt baseret på forventet volumen. API-kald trækker tokens fra din Indhegn-konto – samme token-priser som ved manuel brug.