Kom igång med natomrade-API

Från noll till första svaret på 2 minuter.

Uppdaterad 2026-05-19

Översikt

API:t är ett REST-API som returnerar JSON. Alla endpoints är dokumenterade i Swagger UI och OpenAPI 3-specifikationen.

Auth

Alla /api/v1/*-endpoints kräver X-API-Key-header. Saknas den får du HTTP 401.

curl -H "X-API-Key: zk_din_nyckel_har" \
  "https://natomrade.airpipe.ai/api/v1/lookup/postal?code=11151"

För anonymt anrop används separat /web/*-prefix (begränsat till 5/dygn per IP, 100/dygn globalt).

Första anropet

curl "https://natomrade.airpipe.ai/web/lookup/postal?code=11151"

Svar:

{
  "query": {"type": "postnr", "postnr": "11151"},
  "location": {
    "ort": "Stockholm",
    "latitude": 59.3326, "longitude": 18.0649,
    "kommun": {"kod": "0180", "namn": "STOCKHOLM"}
  },
  "elomrade": {"code": "SE3", "name": "Stockholm", "source": "polygon"},
  "natomrade": {"mga_code": "STH", "svk_id": "006", "name": "Stockholm"},
  "grid_owner": {
    "name": "Ellevio AB",
    "org_nr": "556037-7326",
    "eic": "46X000000000209O",
    "ediel_id": "14900"
  },
  "energy_tax": {
    "year": 2026, "rate_type": "normal",
    "ore_per_kwh_excl_vat": 36.0,
    "ore_per_kwh_incl_vat": 45.0
  }
}

Endpoints

Lookup

Endpoint	Beskrivning	Auth
`GET /web/lookup/postal?code=11151`	Postnr-uppslag (anonymt)	Nej (5/dygn)
`GET /web/lookup/address?adress=...&ort=...`	Adress-uppslag (anonymt)	Nej
`GET /api/v1/lookup/postal?code=...`	Postnr-uppslag	Ja
`GET /api/v1/lookup/address?adress=...&ort=...&postnr=...`	Adress	Ja
`GET /api/v1/lookup/coordinate?lat=...&lon=...`	WGS84-koordinat	Ja
`GET /api/v1/lookup/ort?ort=Stockholm`	Lista postnr i ort	Ja

Master-data

Endpoint	Beskrivning
`GET /api/v1/regions/elomraden`	Lista SE1-SE4
`GET /api/v1/regions/grid-owners?limit=500`	Lista nätägare
`GET /api/v1/prices/current`	Aktuellt spotpris SE1-SE4 (öppet)
`GET /api/v1/prices/spot?area=SE3`	Framtida spotpriser (öppet)
`GET /api/v1/production/current`	Senaste 15-min produktion-mix (öppet)

Rate limit-headers

Varje rate-limited response innehåller info i body:

{
  "error": "rate_limited",
  "scope": "per_ip_per_day",
  "limit": 5,
  "throttle_minutes": 2,
  "throttle_level": 1
}

Vid spam-anrop tripplas en progressiv ban: 2 min → 5 → 10 → 30 → 60 min.