# API-dokumentasjon

> Referanse for api.solkart.no: solprognose, PV-produksjon, TMY, snøtap, sol og horisont, stedlig snølast, terrengkategori og takanalyse for punkter i Norge. Parametre, svar, feil og kvoter, hentet fra koden som kjører.

Kilde: https://solkart.no/api/dokumentasjon · Base-URL https://api.solkart.no

Solkart-API-et gir deg de samme beregningene som verktøyene på solkart.no, som JSON, CSV og fagformater over HTTPS. Alle endepunkter tar et punkt i Norge (WGS84 breddegrad og lengdegrad) og svarer med tall du kan bruke direkte i egne systemer. Base-URL er `https://api.solkart.no`. Ny her? Start på [Kom i gang](/api), som tar deg fra nøkkel til første kall på ett minutt.

## Slik er dokumentasjonen bygd opp

<div class="quick">
<div><b>1. Grunnlag</b> Nøkler, kvoter, feilformat, tid og enheter, asynkrone jobber, caching og versjonering. Les disse én gang.</div>
<div><b>2. Ett produkt per side</b> Hver side har parametertabell, eksempel på forespørsel og ekte svar, feil du kan få, og kobling til verktøyet i nettleseren.</div>
<div><b>3. Maskinlesbart</b> <a href="/openapi.json">OpenAPI 3.1</a> for kodegenerering og <a href="/llms-full.txt">llms-full.txt</a> for KI-assistenter. Hver side finnes også som Markdown.</div>
</div>

## Alle endepunkter

| Endepunkt | Gir | Nøkkel | Side |
|---|---|---|---|
| `GET/POST /api/forecast` | Solinnstråling og PV-produksjon time for time, om lag 60 timer frem | Valgfri (IP-kvote uten) | [Solprognose](/api/dokumentasjon/prognose) |
| `POST /api/forecast/bulk` | Samme for inntil 50 anlegg i ett kall | Valgfri | [Solprognose](/api/dokumentasjon/prognose) |
| `GET/POST /api/forecast/extended` | Prognose ut til 10 døgn | Basic eller høyere | [Solprognose](/api/dokumentasjon/prognose) |
| `GET /api/forecast/nowcast` | Satellittbasert nowcast 0 til 3 timer | Valgfri | [Solprognose](/api/dokumentasjon/prognose) |
| `GET /api/forecast/latest` | Metadata om siste prognosesyklus | Nei | [Solprognose](/api/dokumentasjon/prognose) |
| `GET /api/pv/calc` | Års- og månedsproduksjon for et anlegg (TMY-basert) | Nei | [PV-produksjonsberegning](/api/dokumentasjon/pv) |
| `GET /api/tmy` | Typisk meteorologisk år, 8760 timer, 15 formater | Valgfri (IP-kvote uten) | [TMY Norge](/api/dokumentasjon/tmy) |
| `GET /api/tmy/stats`, `/api/tmy/sources` | Årssummer, P-verdier, valgte år og kilder per celle | Valgfri | [TMY Norge](/api/dokumentasjon/tmy) |
| `GET /api/snowsoiling/calc` | Snø- og smusstap per måned for et anlegg | Nei | [Snøtap](/api/dokumentasjon/snotap) |
| `GET /api/snow/outlook` | Snødekning på panelet neste 10 døgn | Nei | [Snøtap](/api/dokumentasjon/snotap) |
| `GET /api/horizon/terrain` | Terrenghorisont, 720 asimutpunkter | Nei | [Sol og horisont](/api/dokumentasjon/horisont) |
| `POST /api/horizon/rooftop`, `/api/horizon/precise` | Horisont fra takhøyde med nærfelt (DOM 1 m) | Nei i pilot | [Sol og horisont](/api/dokumentasjon/horisont) |
| `GET /api/snowload/calc` | Stedlig karakteristisk snølast (NS-EN 1991-1-3 NA.4.1(2)) | Nei | [Stedlig snølast](/api/dokumentasjon/snolast) |
| `POST /api/terrain/category`, `/api/terrain/jobs` | Terrengkategori og terrengform per sektor (NS-EN 1991-1-4 NA) | Nei i pilot | [Terrengkategori](/api/dokumentasjon/terrengkategori) |
| `POST /api/roof/jobs`, `/api/roof/layout` | Modulplassering og kWp på et tak fra flyfoto og høydemodell | Avtale (passord) | [Takanalyse](/api/dokumentasjon/takanalyse) |
| `POST /api/register` | Opprett gratis API-nøkkel | Nei | [Autentisering](/api/dokumentasjon/autentisering) |
| `GET /health` | Helsesjekk | Nei | [Kvoter, grenser og feil](/api/dokumentasjon/grenser-og-feil) |

## Tre ting du bør vite før første kall

1. **Tidsstempler er starten på timen, i UTC.** En verdi merket `10:00:00Z` gjelder perioden 10:00 til 11:00 UTC. Se [konvensjoner](/api/dokumentasjon/konvensjoner).
2. **Kvoten telles i «anlegg», ikke bare i kall.** Ett anlegg er én unik koordinat per døgn. Samme koordinat kan spørres om mange ganger. Se [kvoter, grenser og feil](/api/dokumentasjon/grenser-og-feil).
3. **Feil kommer alltid som JSON** med feltet `error` og en norsk forklaring, og med riktig HTTP-status. Endepunktene for horisont, terreng og tak legger til en maskinlesbar `code`.


## Sider

- [Autentisering og API-nøkler](https://solkart.no/api/dokumentasjon/autentisering.md): Hvordan du får en API-nøkkel, hvordan du sender den, hvilke endepunkter som krever den, og hvordan du oppbevarer den trygt.
- [Kvoter, grenser og feil](https://solkart.no/api/dokumentasjon/grenser-og-feil.md): Planer og kvoter, hva et «anlegg» er, hvor raskt du kan kalle hvert endepunkt, og hvordan feilsvar ser ut med status, error og code.
- [Konvensjoner: tid, enheter og koordinater](https://solkart.no/api/dokumentasjon/konvensjoner.md): Tidsstempler (bin-start, UTC), enheter, asimut- og helningskonvensjoner per endepunkt, koordinatsystemer, dataformater og HTTP-detaljer som gjelder på tvers av API-et.
- [Asynkrone jobber](https://solkart.no/api/dokumentasjon/jobber.md): Terrengkategori og takanalyse kan ta opptil et par minutter. Jobbendepunktene legger analysen i kø og lar deg hente status og resultat når den er ferdig.
- [Caching, versjonering og utfasing](https://solkart.no/api/dokumentasjon/caching-og-versjonering.md): Hvor ofte data endres, hvilke Cache-Control-hoder hvert endepunkt setter, hvordan du finner ut hvilken modellversjon du fikk, og hva som fases ut når.
- [Solprognose](https://solkart.no/api/dokumentasjon/prognose.md): Solinnstråling (GHI) og PV-produksjon time for time, 60 timer frem, for ethvert punkt eller anlegg i Norge. Bulk for inntil 50 anlegg, utvidet prognose til 10 døgn, satellittbasert nowcast og metadata om siste syklus.
- [PV-produksjonsberegning](https://solkart.no/api/dokumentasjon/pv.md): Forventet års- og månedsproduksjon for et solcelleanlegg hvor som helst i Norge, regnet på TMY Norge med terrenghorisont. Flere takflater, klipping, snøtap, P50 til P95 og optimal vinkel. Samme beregning som PVGIS, med norske data.
- [TMY Norge](https://solkart.no/api/dokumentasjon/tmy.md): Typisk meteorologisk år for ethvert punkt på fastlands-Norge, 8760 timer med GHI, DNI, DHI, temperatur, fukt, vind og trykk. 15 filformater, fire produkter, P50 til P95, statistikk og kilder per celle.
- [Snøtap for solceller](https://solkart.no/api/dokumentasjon/snotap.md): Stedlige snø- og smusstap per måned for et solcelleanlegg, samme modell som NS 3031:2025-tabellene bygger på, kjørt med lokale seNorge-data for din helning og montasje. Pluss snødekning på panelet neste 10 døgn.
- [Sol og horisont](https://solkart.no/api/dokumentasjon/horisont.md): Horisontprofil i 720 retninger for et punkt i Norge, i tre nivåer: terreng fra DTM10 (gratis, uten nøkkel), fra takhøyde med nærfelt fra DOM 1 m, og presis analyse med skyggetap, PDF og CSV. Eksport til PVsyst, PV*SOL, SAM, HelioScope og Meteonorm.
- [Takanalyse](https://solkart.no/api/dokumentasjon/takanalyse.md): Modulplassering, antall moduler og kWp for et tak fra bygningsomriss (FKB), høydemodell 1 m og flyfoto med SunPoint bildeanalyse. Skråtak og flate tak, øst/vest eller sør, avstander etter NEK 400-7-712, tegning som PNG og GeoJSON. Krever avtale.
- [Stedlig snølast](https://solkart.no/api/dokumentasjon/snolast.md): Karakteristisk snølast på mark for en tomt, regnet etter SINTEF-metoden (alternativ metode i NS-EN 1991-1-3 NA.4.1(2)) på NVEs seNorge-serie fra 1957, med sammenligning mot Eurokodens kommunetabell. JSON eller CSV, ingen nøkkel.
- [Terrengkategori og terrengform](https://solkart.no/api/dokumentasjon/terrengkategori.md): Terrengruhetskategori etter NS-EN 1991-1-4:2005/NA:2009 for et punkt, fastsatt retningsvis i 72 sektorer ut til 10 km fra Kartverkets høydemodeller, FKB-bygninger og NIBIO AR5, med overgangssoner, kontrollpunkter, terrengformfaktor c_o etter NA.4.3.3 og RIB-overstyring. JSON, PDF eller HTML. Beta.
- [Endringslogg](https://solkart.no/api/dokumentasjon/endringslogg.md): Endringer i api.solkart.no i omvendt kronologisk rekkefølge, med dato. Varslede utfasinger står øverst.