# Autocomplete på etage og dør

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

Type-ahead over enhedsadresser med etage og dør — sidste trin fra vej over husnummer til enhed.

Erstatter DAWA’s `/adresser/autocomplete`. Med `adgangsadresseid` får du enhederne på en valgt adgangsadresse i læserækkefølge — kælder, stuen, 1. sal og op — indsnævret af `q`, når teksten indsnævrer dem. Uden søges der i enhedernes fulde adressetekst, fx "Vestergade 10, 2. th".

Hvert hit er `{ type: "adresse", tekst, vaerdi, adgangsadresse_id, etage, doer }`, og `vaerdi` er enhedens UUID, som også slås op på [`/v1/adresse/{uuid}`](https://grundfast.dk/docs/api/adresse). En adgangsadresse uden etager — et parcelhus — har præcis én enhed med `etage` og `doer` som `null`.

**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 | nej | Søgetekst, mindst 2 tegn. Påkrævet, medmindre `adgangsadresseid` er sat. |
| `adgangsadresseid` | query | string (UUID) | nej | List enhederne på denne adgangsadresse. |

## Eksempel

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

## Svar (200)

```json
{
  "type": "adresse",
  "antal": 4,
  "resultater": [
    {
      "type": "adresse",
      "tekst": "Vestergade 10, st. th, 8000 Aarhus C",
      "vaerdi": "0a3f50a3-1e3c-32b8-e044-0003ba298018",
      "adgangsadresse_id": "0a3f507b-4a0a-32b8-e044-0003ba298018",
      "etage": "st",
      "doer": "th"
    },
    {
      "type": "adresse",
      "tekst": "Vestergade 10, 1. th, 8000 Aarhus C",
      "vaerdi": "0a3f50a3-1e3d-32b8-e044-0003ba298018",
      "adgangsadresse_id": "0a3f507b-4a0a-32b8-e044-0003ba298018",
      "etage": "1",
      "doer": "th"
    }
  ]
}
```

## Vigtige felter

| Felt | Type | Betydning |
| --- | --- | --- |
| `resultater[].vaerdi` | string (UUID) | Enhedens (DAR-adressens) UUID. |
| `resultater[].adgangsadresse_id` | string (UUID) | Den adgangsadresse, enheden hører til. |
| `resultater[].etage` | string \| null | Etagen, fx `"st"`, `"1"` eller `"kl"`; `null` for en enhed uden etage. |
| `resultater[].doer` | string \| null | Døren, fx `"th"`, `"tv"` eller `"mf"`; `null` for en enhed uden dør. |

## Fejl

| Status | Betydning |
| --- | --- |
| 400 | Hverken `q` (mindst 2 tegn) eller `adgangsadresseid` er sat, eller `adgangsadresseid` er ikke et UUID. |
| 401 | Nøglen mangler eller er ugyldig. |
| 429 | Burst-grænsen eller månedskvoten er nået. Se `Retry-After`. |
| 503 | Adresseindekset eller enhedsindekset (etage og dør) er ikke indlæst i dette miljø endnu. |