API Dokumentation

API‑dokumentation

Opslag i Robinsonlisten via REST‑API

🚀 Kom i gang på få minutter

Hurtig start: Hent jeres API‑nøgle på forsiden (100 gratis opslag) eller se priser for ubegrænsede opslag.

API Endpoints

Simple, RESTful endpoints til Robinsonliste opslag og adressenormalisering

Robinsonliste Identifikation

GET https://robinsonlistenapi.dk/api/v1/identifications

✓ Enkelt person opslag via query parametre

POST https://robinsonlistenapi.dk/api/v1/identifications Anbefalet

✓ Batch opslag (op til 1.000 personer per request) – Bedst til høj volumen

Adresse Normalisering GRATIS

Validér og normaliser danske adresser ved hjælp af officiel DAWA data

POST https://robinsonlistenapi.dk/api/v1/address/normalize

✓ Normaliser og validér en enkelt dansk adresse

POST https://robinsonlistenapi.dk/api/v1/address/normalize/batch

✓ Batch adresse normalisering (op til 100 adresser per request)

Godkendelse

Inkludér jeres API‑nøgle i forespørgslen:

{
  "api_key": "your_api_key_here",
  "search": [...]
}

Request‑format

Send en liste med personer, I vil kontrollere. Hver person SKAL indeholde en adresse (med postnummer). Fornavn og efternavn er valgfrie men stærkt anbefalet for præcis matching.

Parameter Type Påkrævet Beskrivelse
first_name string Optional Fornavn (valgfrit men anbefalet)
last_name string Optional Efternavn (valgfrit men anbefalet)
address string Optional Adresse inkl. postnummer, f.eks. "Vesterbrogade 1, 1620" (PÅKRÆVET)
phone_number string Valgfrit Telefonnummer (dansk format)
kvhx string Valgfrit Officiel dansk adressekode (KVHX)
query string Valgfrit Generel søgeforespørgsel (prøver både navn og adresse)
id string/number Valgfrit Dit interne ID (returneres i response til tracking)

Bemærk: Angiv mindst én søgeparameter. API'et vil forsøge at matche på navn, adresse, telefonnummer eller KVHX-kode.

Eksempel

Responsformat

Svarfelter

Felt Beskrivelse
robinsonlisten "1" = på listen, "0" = ikke på listen
robinson_matched_on Array af felter der matchede (f.eks., ["first_name", "last_name", "address"]). Tomt array hvis intet match.
phone_lookup_data Kun ved telefon opslag - data om ejeren af nummeret

Eksempel Fortolkning

Hvis response viser:

  
    [
      {
        "query": "Marcus Jensen",
        "result": {
          "robinsonlisten": "1",
          "robinson_matched_on": "first_name, last_name",
          "robinson_match_attempts": "first_name, last_name, address"
        }
      }
    ]
  

Betyder det: Søgningen på "Marcus Jensen" returnerede et match. Personen er på Robinsonlisten og blev matchet på navn (first_name, last_name).

Adresse Normalisering API

Adresse Normalisering API'et validerer og normaliserer danske adresser ved hjælp af officiel DAWA (Danmarks Adressers Web API) data.

Gratis at bruge: Adresse normaliserings requests spores til overvågning men tæller IKKE med i dine API forbrugsgrænser eller fakturering.

Enkelt Adresse Normalisering

POST https://robinsonlistenapi.dk/api/v1/address/normalize

Request Parametre

Parameter Type Påkrævet Beskrivelse
api_key string Ja Din API nøgle
address string Ja Den danske adresse der skal normaliseres

Eksempel Request

{
  "api_key": "your_api_key_here",
  "address": "Vesterbrogade 1, 1620"
}

Response Format

{
  "address": "Vesterbrogade 1, 1620",
  "success": true,
  "match_quality": "A",
  "normalized_address": "Vesterbrogade 1, 1., 1620 København V",
  "kvhx": "01010101__1__1",
  "components": {
    "municipality_code": "0101",
    "road_code": "0101",
    "house_number": "1",
    "floor": "1",
    "door": null,
    "postal_code": "1620",
    "city": "København V"
  },
  "coordinates": {
    "lat": 55.674557,
    "lng": 12.561615
  }
}

Batch Adresse Normalisering

POST https://robinsonlistenapi.dk/api/v1/address/normalize/batch

Maksimum 100 adresser per request

Eksempel Request

{
  "api_key": "your_api_key_here",
  "addresses": [
    "Vesterbrogade 1, 1620",
    "Nørrebrogade 20, 2200",
    "Amagerbrogade 150, 2300"
  ]
}

Response Felter

Felt Beskrivelse
success Om adressen blev normaliseret succesfuldt
match_quality A = perfekt match, B = godt match, C = usikkert match
normalized_address Det officielle normaliserede adresseformat
kvhx Officiel dansk adressekode (Kommune-Vej-Husnummer-Etage-Dør)
components Strukturerede adressekomponenter (kommune, vej, husnummer, etage, dør, postnummer, by)
coordinates GPS koordinater (breddegrad og længdegrad)

Batch Opslag

Du kan sende flere personer i samme request for at optimere hastigheden.

Tip: For store datamængder (>1000 personer) – kontakt os for adgang til vores dedikerede batch‑endpoint med højere grænser.

Brug for hjælp?

Priser & Planer

Se vores priser eller få adgang til ubegrænsede opslag

Læs mere →

Kontakt Support

Har du spørgsmål eller brug for teknisk assistance?

Marcus Wilstrup

Brug for specialudviklet løsning eller hjælp til API-integration?

Arbejd direkte med Marcus Wilstrup, skaberen af Robinsonlisten API. Få eksperthjælp til at bygge skalerbare webapplikationer, integrere komplekse API'er og modernisere jeres tekniske infrastruktur.

Ruby on Rails • API‑udvikling • Systemintegration • Teknisk rådgivning