# Autocomplete på adgangsadresser

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

Type-ahead over adgangsadresser på DAWA’s egen sti, med tekst og UUID for hvert hit.

Erstatter DAWA’s `/adgangsadresser/autocomplete`. Hittene er de samme som fra [`/v1/autocomplete`](https://grundfast.dk/docs/api/autocomplete) med `type=adgangsadresse`, i samme `{ type, antal, resultater }`-form og højst 20 ad gangen.

Skal du bruge BFE-nummer og koordinat i hvert hit, så brug [`/v1/adresse/search`](https://grundfast.dk/docs/api/adresse-search) i stedet.

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

**Afregning:** Ét kald pr. forespørgsel — også pr. tastetryk.

## Parametre

| Navn | Placering | Type | Påkrævet | Beskrivelse |
| --- | --- | --- | --- | --- |
| `q` | query | string | ja | Søgetekst, mindst 2 tegn efter trim. Kun de første 64 tegn bruges. |

## Eksempel

```bash
curl -G "https://api.grundfast.dk/v1/adgangsadresser/autocomplete" \
  --data-urlencode "q=rådhuspladsen 1" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"
```

## Svar (200)

```json
{
  "type": "adgangsadresse",
  "antal": 20,
  "resultater": [
    {
      "type": "adgangsadresse",
      "tekst": "Rådhuspladsen 1, 1550 København V",
      "vaerdi": "0a3f507a-ec01-32b8-e044-0003ba298018"
    },
    {
      "type": "adgangsadresse",
      "tekst": "Rådhuspladsen 14, 1550 København V",
      "vaerdi": "0a3f507a-ec0e-32b8-e044-0003ba298018"
    }
  ]
}
```

## Vigtige felter

| Felt | Type | Betydning |
| --- | --- | --- |
| `resultater[].vaerdi` | string (UUID) | Adgangsadressens UUID. |
| `resultater[].tekst` | string | Adressen som visningstekst, fx "Rådhuspladsen 1, 1550 København V". |

## Fejl

| Status | Betydning |
| --- | --- |
| 400 | `q` 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ø. |