Caching, versjonering og utfasing
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.
Hvor ofte endrer dataene seg?
| Data | Oppdateres | Hent |
|---|---|---|
Solprognose (/api/forecast*) |
Ny syklus hver time, publisert rundt 50 minutter over hel time | Én gang per time per anlegg. Sjekk cycle_time. |
Nowcast (/api/forecast/nowcast) |
Hvert 15. minutt (satellitt) | Hvert 15. minutt |
Snøutsikt (/api/snow/outlook) |
Daglig (seNorge) | Én gang per dag |
| TMY, PV-kalkulator, snøtap, snølast, horisont | Klimatologi og statiske modeller; endres bare ved nye produktversjoner | Lagre resultatet hos deg |
| Terrengkategori, takanalyse | Statisk grunnlag; ny analyse gir samme svar med samme parametre | Lagre rapporten hos deg |
Bruk GET /api/forecast/latest (uten kvote) til å se om det finnes en ny cycle_time før du henter prognoser for mange anlegg.
Cache-Control per endepunkt
| Endepunkt | Hode | Ekstra |
|---|---|---|
/api/forecast, /extended, /latest |
Ingen | /extended og /latest bruker V1.5-rutenettet (production_v1) |
/api/forecast/bulk |
public, max-age=<sekunder til neste syklus> (minst 60) |
X-Solkart-Cache: HIT|MISS, X-Solkart-Cache-Ttl; nøkkel er SHA-256 av kroppen |
/api/forecast/nowcast |
public, max-age=120 |
|
/api/tmy, /api/tmy/stats, /api/tmy/sources |
public, max-age=86400 |
X-Tmy-Cell, X-Tmy-Cell-Distance-Km, X-Tmy-Product |
/api/pv/calc |
public, max-age=86400 (JSON) |
X-Pv-Cache: HIT når resultatet lå i vår cache (7 døgn) |
/api/snowload/calc |
public, max-age=86400 (JSON) |
|
/api/snowsoiling/calc |
public, max-age=86400 |
X-Snowsoil-Cache: HIT |
/api/snow/outlook |
public, max-age=3600 |
X-Snow-Outlook-Cache: HIT|MISS |
/api/horizon/terrain |
public, max-age=86400 |
X-Horizon-Tile-Key, X-DTM-Year, X-Api-Version |
/api/horizon/rooftop, /precise |
Ingen | X-Worker-Request-Id, X-API-Tier, X-Quota-Remaining |
/api/terrain/*, /api/roof/* |
private, no-store (tegning.png: private, max-age=900) |
X-Terrengkategori, X-Konfidens (terreng, PDF/HTML); X-Moduler, X-Kwp (tegning) |
Det finnes ikke ETag eller Last-Modified, og If-None-Match støttes ikke. Kvote- og planvurdering skjer før cachen sjekkes, så et cachet bulk-svar bruker fortsatt kvote.
Hvilken versjon fikk jeg?
Svarene forteller selv hva som ble brukt. Logg disse feltene sammen med resultatet.
| Endepunkt | Felt | Verdier i dag |
|---|---|---|
/api/forecast* |
model, data_mode |
production_v2_3b / v23b, v23b_daily; ved fall tilbake production_v1 / latest, daily, corrected, rolling |
/api/forecast/nowcast |
source |
v7_eumetsat_nowcast eller v23b_fallback |
/api/horizon/terrain |
version, api_tier, dtm_year |
v3.1, terrain |
/api/horizon/rooftop, /precise |
version, api_tier, dom_year, dtm_year |
v3.1 (v3.2 med panelgeometri), rooftop, precise |
/api/tmy |
meta.product, meta.license_version, meta.generator |
ens_tmy30, tmy-v1-2026-09-30 |
/api/pv/calc |
meta.generator, inputs.meteo_data.source |
SunPoint PV-kalkulator v1 |
/api/snowload/calc, /api/snowsoiling/calc |
method.reference |
SINTEF 102027401 v2; IFE/E-2024/005 |
/api/terrain/category |
norm, meta |
NS-EN 1991-1-4:2005/NA:2009 |
/api/roof/* |
meta.versjon, grunnlag |
1 |
Modellvalg i prognosen
Standard er V2.3b, modellen som også driver kartet på solkart.no. De eldre variantene kan fortsatt velges, men fases ut:
| Valg | Gir | Status |
|---|---|---|
| (ingen) | V2.3b, data_mode: "v23b" |
Anbefalt |
daily=true |
V2.3b sydd fra midnatt, v23b_daily (Basic+) |
Anbefalt |
model=v1 eller v23b=false |
V1.5-rutenettet | Fases ut 19. november 2026 |
corrected=true |
V1.5 med statistisk korreksjon | Fases ut 19. november 2026 |
fresh=true |
V1.5 rullerende sammensying | Fases ut 19. november 2026 |
precise=true |
PV-modell i pvlib med PVGIS-horisont (tregere) | Beholdes |
snow=1 |
Snøtapsfaktorer fra seNorge på produksjonen | Beholdes |
Etter 19. november 2026 ignoreres model, corrected og fresh, og svaret bruker V2.3b. Integrasjoner som ikke sender disse, påvirkes ikke.
Slik endrer vi API-et
- Uten varsel: nye felt i svar, nye valgfrie parametre, nye formater, nye endepunkter, mer presise tall når modellene forbedres.
- Med varsel på endringsloggen og minst 60 dager før: fjerning av felt eller parametre, endret betydning av et felt, endret tidskonvensjon, strengere validering.
- Sikkerhetsfeil og faktafeil rettes umiddelbart, og endringen dokumenteres samme dag (som solposisjonsfeilen 15. september 2026).
- Det finnes ingen versjon i URL-en eller i hoder. Klienter bør tåle ukjente felt og ikke bruke rekkefølgen på felt.
TMY-lisens
TMY-nedlastinger merkes med license_version: "tmy-v1-2026-09-30": dataene er lisensiert for prosjekter som prosjekteres til og med 30. september 2026. Ny versjon utstedes før den datoen; klienter bør lese meta.license og meta.license_no og vise teksten videre til sluttbruker.