# Vask en adresse

`GET /v1/datavask/adgangsadresser` · DAWA-kompatibel

Match en uformateret adressestreng mod DAR og få op til 10 rangerede kandidater og en sikkerhedskategori A, B eller C.

Erstatter DAWA’s `/datavask/adgangsadresser`. Strengen sammenlignes med alle adgangsadresser efter lighed, så stavefejl, manglende postnumre og forkortelser stadig kan give et match. Svaret er `{ kategori, antal, resultater }`, og hver kandidat har sin `lighed` (0–1).

**A** er et sikkert match: næsten eksakt, eller klart bedre end nummer to. **B** er et sandsynligt match, der bør bekræftes. **C** er usikkert. Læs `antal` før `kategori`: `C` med `antal: 0` betyder, at intet matchede, mens `C` med kandidater betyder, at de skal gennemgås.

**Godkendelse:** `Authorization: Bearer gf_live_…` (eller `gf_test_…`)

**Afregning:** Ét kald.

## Parametre

| Navn | Placering | Type | Påkrævet | Beskrivelse |
| --- | --- | --- | --- | --- |
| `betegnelse` | query | string | ja | Adressen, der skal vaskes, mindst 2 tegn efter trim. Tekst ud over 128 tegn ignoreres. |

## Eksempel

```bash
curl -G "https://api.grundfast.dk/v1/datavask/adgangsadresser" \
  --data-urlencode "betegnelse=rådhuspladsen 1, københavn" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"
```

## Svar (200)

```json
{
  "kategori": "B",
  "antal": 10,
  "resultater": [
    {
      "betegnelse": "Rådhuspladsen 1, 1550 København V",
      "adgangsadresse_id": "0a3f507a-ec01-32b8-e044-0003ba298018",
      "bfe_nummer": 6033528,
      "vejnavn": "Rådhuspladsen",
      "husnr": "1",
      "postnr": "1550",
      "postnrnavn": "København V",
      "kommunekode": "0101",
      "koordinat": { "lon": 12.5695777, "lat": 55.6756275 },
      "lighed": 0.813
    },
    {
      "betegnelse": "Rådhuspladsen 11, 1550 København V",
      "adgangsadresse_id": "0a3f507a-ec07-32b8-e044-0003ba298018",
      "bfe_nummer": 100058380,
      "vejnavn": "Rådhuspladsen",
      "husnr": "11",
      "postnr": "1550",
      "postnrnavn": "København V",
      "kommunekode": "0101",
      "koordinat": { "lon": 12.5686571, "lat": 55.6763797 },
      "lighed": 0.735
    }
  ],
  "meta": {
    "kilde": "Datafordeler DAR via Grundfast",
    "grundfast_version": "0.1.0"
  }
}
```

## Vigtige felter

| Felt | Type | Betydning |
| --- | --- | --- |
| `kategori` | 'A' \| 'B' \| 'C' | Sikkerheden for det bedste match. Læs den sammen med `antal`. |
| `antal` | integer | Antal kandidater, højst 10. `0` betyder intet match. |
| `resultater[].lighed` | number | Trigram-lighed mellem input og kandidat, 0–1 med tre decimaler. Listen er sorteret faldende. |
| `resultater[].adgangsadresse_id` | string (UUID) | DAR-husnummerets UUID for kandidaten. Kandidaten har også `bfe_nummer` og `koordinat`. |

## Fejl

| Status | Betydning |
| --- | --- |
| 400 | `betegnelse` mangler eller er kortere end 2 tegn. |
| 401 | Nøglen mangler eller er ugyldig. |
| 429 | Burst-grænsen eller månedskvoten er nået. Se `Retry-After`. |
| 503 | Adresseindekset er ikke slået til eller endnu ikke indlæst i dette miljø. |