# Hent vejnavne

`GET /v1/vejnavne` · DAWA-kompatibel

Alle forskellige danske vejnavne, side for side og valgfrit afgrænset til én kommune.

Erstatter DAWA’s `/vejnavne` med samme `side`/`per_side`. Hvert vejnavn er en streng, ikke et objekt, og et navn optræder kun én gang, selvom det findes i mange kommuner. Brug `kommunekode` for kun at få vejnavnene i én kommune.

Navnene er sorteret alfabetisk efter dansk sortering. Svaret er `{ antal, total, vejnavne, meta }`, hvor `total` er antallet af vejnavne i hele listen.

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

**Afregning:** Ét kald pr. side.

## Parametre

| Navn | Placering | Type | Påkrævet | Beskrivelse |
| --- | --- | --- | --- | --- |
| `per_side` | query | integer | nej | Antal vejnavne pr. side, højst 200. |
| `side` | query | integer | nej | Sidenummer, startende ved 1. |
| `kommunekode` | query | string | nej | Afgrænser til én kommune, fx `0101` (1–4 cifre; `101` læses som `0101`). |

## Eksempel

```bash
curl "https://api.grundfast.dk/v1/vejnavne?per_side=100&kommunekode=0101" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"
```

## Svar (200)

```json
{
  "antal": 100,
  "total": 2683,
  "vejnavne": ["A-Vej", "A.C. Meyers Vænge", "A.F. Beyers Vej"],
  "meta": {
    "kilde": "Datafordeler DAR (vejnavne) via Grundfast",
    "grundfast_version": "0.1.0"
  }
}
```

## Vigtige felter

| Felt | Type | Betydning |
| --- | --- | --- |
| `antal` | integer | Antal vejnavne på denne side. Mindre end `per_side` på sidste side. |
| `vejnavne` | string[] | Vejnavnene på siden. |
| `total` | integer | Antal vejnavne i hele listen (eller i kommunen). Sidst side er nået, når `side × per_side ≥ total`. |

## Fejl

| Status | Betydning |
| --- | --- |
| 400 | `kommunekode` er ikke 1–4 cifre. |
| 401 | Nøglen mangler eller er ugyldig. |
| 429 | Burst-grænsen eller månedskvoten er nået. Se `Retry-After`. |