# Autocomplete på postnumre

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

Postnumre, der starter med de indtastede cifre eller har et distriktsnavn, der indeholder teksten.

Erstatter DAWA’s `/postnumre/autocomplete`. `q` matcher både starten af nummeret (`80` finder 8000) og hvor som helst i distriktsnavnet, uden hensyn til store og små bogstaver og med tolerance for `oe`/`aa` i stedet for ø/å. Der returneres højst 20 hits.

Svaret har samme form som [`/v1/postnumre`](https://grundfast.dk/docs/api/postnumre); `total` er antallet af postnumre i hele listen, ikke antallet af hits.

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

**Afregning:** Ét kald pr. forespørgsel.

## Parametre

| Navn | Placering | Type | Påkrævet | Beskrivelse |
| --- | --- | --- | --- | --- |
| `q` | query | string | ja | Starten af et postnummer eller en del af distriktsnavnet. Kun de første 64 tegn bruges. |
| `stormodtagere` | query | boolean | nej | Søg også i de historiske stormodtager-postnumre. |

## Eksempel

```bash
curl "https://api.grundfast.dk/v1/postnumre/autocomplete?q=aarhus" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"
```

## Svar (200)

```json
{
  "antal": 3,
  "total": 1089,
  "postnumre": [
    { "nr": "8000", "navn": "Aarhus C", "stormodtager": false },
    { "nr": "8200", "navn": "Aarhus N", "stormodtager": false },
    { "nr": "8210", "navn": "Aarhus V", "stormodtager": false }
  ],
  "meta": {
    "kilde": "Datafordeler DAR (postnumre) via Grundfast",
    "grundfast_version": "0.1.0"
  }
}
```

## Vigtige felter

| Felt | Type | Betydning |
| --- | --- | --- |
| `total` | integer | Antal postnumre i hele listen — ikke antallet af hits. |
| `postnumre[]` | object[] | Højst 20 hits som `{ nr, navn, stormodtager }`, sorteret efter nummer. |
| `antal` | integer | Antal postnumre i `postnumre` — kun de bedste hits, ikke hele korpuset. |

## Fejl

| Status | Betydning |
| --- | --- |
| 400 | `q` mangler eller er tom. |
| 401 | Nøglen mangler eller er ugyldig. |
| 429 | Burst-grænsen eller månedskvoten er nået. Se `Retry-After`. |