Produktion: GET /api/v1/pv-yield
GET /api/v1/pv-yield svarar med det specifika utbytet i kWh/kWp per år och per månad, instrålningen i panelplanet, det lokala optimumet och orienteringsfaktorn för valfri punkt i Sverige × lutning × väderstreck, och med en kwp-parameter års- och månads-kWh. Datamängden är PVGIS 5.3 månadsinstrålning per ungefär 25 km rutnätsnod körd genom solar-core-motorn för 19 lutningar × 36 väderstreck; ett uppslag interpolerar mellan de fyra omgivande noderna och i lutningssteg om 5° och väderstreckssteg om 10°. Kompassväderstreck (0 = N, 180 = S), 14 % systemförlust som standard, fri horisont. /pv-yield/matrix ger hela matrisen lutning × väderstreck, /pv-yield/batch tar upp till 50 punkter i en POST, /pv-yield/meta beskriver datamängden, och /pv-yield/openapi.json är kontraktet.
Simulering: POST /api/v1/simulation
POST /api/v1/simulation kör ett år utan skottdag timme för timme för din egen produktionsserie (8 760 timvärden, eller en typisk dag per månad) och förbrukningsserie (timvärden, eller en års-kWh fördelad med hushållsmodellen plus elbilskilometer per dag), med ett batteri som startar på sin lägsta nivå den 1 januari och bär sitt tillstånd från dag till dag. Priserna är förvalet se_spot — det senaste årets day-ahead-profil för elområdet med leverantörspåslag, elnätsavgift, energiskatt och moms — eller dina egna: ett fast tal, en profil månad × timme eller 8 760 värden. POST /api/v1/simulation/battery-strategies kör samma hus för upp till 25 celler batteristorlek × strategi — egenanvändning, arbitrage, effekttoppskapning och kombinerad — och varje anrop kör också huset utan batteri, så besparingen är skillnaden.
Gränser, cache och dokumentation
Utan nyckel: 60 anrop för produktion, 10 matrisanrop, 10 simuleringsanrop och 50 simuleringsceller per minut och IP-adress. Med en x-api-key: 600 produktionsanrop, 60 matrisanropanrop, 100 anrop och 500 celler; en nyckel öppnar båda API:erna. Varje produktionssvar bär Cache-Control public, max-age 86 400 och en ETag från datamängdens version och de normaliserade parametrarna, så en upprepad GET med If-None-Match svarar 304. CORS är öppen. Inget vid anropet rör databasen, en underprocess eller en extern tjänst: datamängden ligger i minnet och simuleringen är bara CPU, med högst 2 simuleringsanrop åt gången per nod (ett tredje får 503 och Retry-After 1). Dokumentationssidan är /docs/api.
HubSpot och Fortnox
HubSpot: ett prospekt med e-post slås upp som kontakt på den e-posten, eller skapas, och en affär skapas och kopplas till kontakten; när prospektet ändras uppdateras affären. Kalkyldata kommer som numsolar_-egenskaper på affären: adress, latitud och longitud, antal paneler och paneltitel, total kW, antal växelriktare och titel, batteri-kWh, antal laddare, takytor, vuxna i hushållet och husets huvudsäkring. Fortnox: offerten blir en faktura där varje rad bär husarbetstypen för radens avdragsklass — SOLARCELLS, STORAGESELFPRODUCEDELECTRICITY eller CHARGINGSTATIONELECTRICVEHICLE — och skattereduktionens belopp summeras per arbetstyp och delas mellan de vuxna så som offertens avdrag för grön teknik delades, en del per påbörjade 50 000 kr om du inte ställt in en annan delning.
Formify och din webbplats
Formify: avtalet går ut för e-signering från offerten; Numsolar registrerar en webhook för skapat, öppnat, signerat, slutfört, återkallat och raderat, varje undertecknares status och signeringstid sparas på offertens avtal, och det signerade dokumentet kommer tillbaka som en bilaga på offerten. Din webbplats: konfiguratorn som inbäddning på /embedded/<slug> med dina paket, SDK:t dokumenterat på /docs/sdk, och den publika länken /i/<din slug> för annonser. Integrationerna ingår i abonnemanget; gratislistningen har det publika API:et och listningen, inte integrationerna.
Vad API:et inte är, ännu
Det publika API:et täcker produktion och simulering. Det finns inget organisationsbundet API för dina leads, offerter eller prospekt, inga webhooks från Numsolar till dina system och inga API-nycklar per organisation; x-api-key-nivån är en nivå för anropsgränser på de publika ändpunkterna. Dina leads når dig via mejl, i inkorgen och genom HubSpot.
