{ "openapi": "3.0.0", "info": { "title": "Photovoltaik Prognose und Vorhersage", "description": "AI-based photovoltaic power prediction for unmetered PV plants. Powered by our industry-leading irradiance and real-time weather data.", "termsOfService": "https://corrently.io/books/stromdao-gmbh/page/fair-use-policy", "contact": { "name": "STROMDAO GmbH", "url": "https://stromdao.de/", "email": "dev@stromdao.com" }, "version": "1.0.0" }, "externalDocs": { "description": "Öffentliche Dokumentation", "url": "https://corrently.io/books/vorhersage-photovoltaik-stromerzeugung" }, "servers": [ { "url": "https://api.corrently.io" } ], "paths": { "/v2.0/solar/prediction": { "get": { "tags": [ "default" ], "summary": "Vorhersage: PV roof-top (deg:33) in Wiesloch Germany- Facing south (az:0)", "description": "The PV generation forecast for unmetered PV systems makes it possible to predict production of a PV system on an hourly basis for the next 4 days without having your own metering equipment or system-specific generation data.", "parameters": [ { "name": "X-RapidAPI-Key", "in": "header", "description": "(Required) Could be retrieved from rapidapi.com account (free)", "required": false, "style": "simple", "explode": false, "schema": { "type": "string" }, "example": "{{X-RapidAPI-Key}}" }, { "name": "Accept", "in": "header", "required": false, "style": "simple", "explode": false, "schema": { "type": "string" }, "example": "application/json" }, { "name": "lon", "in": "query", "description": "(Required) Geocode longitude part of pv plant", "required": false, "style": "form", "explode": true, "schema": { "type": "number" }, "example": "8.7352799" }, { "name": "lat", "in": "query", "description": "(Required) Geocode latitude part of pv plant", "required": false, "style": "form", "explode": true, "schema": { "type": "number" }, "example": "49.2971779" }, { "name": "wp", "in": "query", "description": "(Required) Installed Watt-Peak (eq. kWp/1000)", "required": false, "style": "form", "explode": true, "schema": { "type": "integer" }, "example": "4400" }, { "name": "deg", "in": "query", "description": "PV plant declination degrees, 0 (horizontal) … 90 (vertical)", "required": false, "style": "form", "explode": true, "schema": { "type": "integer" }, "example": "33" }, { "name": "az", "in": "query", "description": "plane azimuth, -180 … 180 (-180 = north, -90 = east, 0 = south, 90 = west, 180 = north)", "required": false, "style": "form", "explode": true, "schema": { "type": "integer" }, "example": "0" } ], "responses": { "200": { "description": "OK", "headers": { "Date": { "style": "simple", "explode": false, "schema": { "type": "string", "example": "Wed, 02 Nov 2022 23:17:33 GMT" } }, "Content-Type": { "style": "simple", "explode": false, "schema": { "type": "string", "example": "application/json; charset=utf-8" } }, "Transfer-Encoding": { "style": "simple", "explode": false, "schema": { "type": "string", "example": "chunked" } }, "Connection": { "style": "simple", "explode": false, "schema": { "type": "string", "example": "keep-alive" } }, "x-request-id": { "style": "simple", "explode": false, "schema": { "type": "string", "example": "6a90a9ec-bdaf-4189-9ca5-3e8b8d25dcc5" } }, "x-rate-limit-limit": { "style": "simple", "explode": false, "schema": { "type": "integer", "example": 30 } }, "x-rate-limit-remaining": { "style": "simple", "explode": false, "schema": { "type": "integer", "example": 29 } }, "x-rate-limit-reset": { "style": "simple", "explode": false, "schema": { "type": "integer", "example": 1667431062625 } }, "x-request-compute": { "style": "simple", "explode": false, "schema": { "type": "integer", "example": 5654 } }, "x-request-transfer": { "style": "simple", "explode": false, "schema": { "type": "integer", "example": 8604 } }, "x-sessioncredit-compute": { "style": "simple", "explode": false, "schema": { "type": "integer", "example": 89999984038 } }, "x-sessioncredit-transfer": { "style": "simple", "explode": false, "schema": { "type": "number", "example": -192875 } }, "x-sessioncredit-start": { "style": "simple", "explode": false, "schema": { "type": "integer", "example": 1667428543550 } }, "access-control-allow-origin": { "style": "simple", "explode": false, "schema": { "type": "string", "example": "*" } }, "etag": { "style": "simple", "explode": false, "schema": { "type": "string", "example": "W/\"219c-VzsPaTXxIffHhIW5X+PLy/PJRqs\"" } }, "x-served-by": { "style": "simple", "explode": false, "schema": { "type": "string", "example": "api.corrently.io" } }, "CF-Cache-Status": { "style": "simple", "explode": false, "schema": { "type": "string", "example": "DYNAMIC" } }, "Report-To": { "style": "simple", "explode": false, "schema": { "type": "string", "example": "{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v3?s=j3Pe8t%2F1eX3t1RGvUyo%2BRfDQIYG3ZSCJSxhVqriSV9eZv4s5K2NnOucUIp%2Fa%2BuBtVlT3cTD2WJorOMzxaL15MVPWvMwTkoEQRekOGsBD6vjD3o4fZRtG8IARf%2BoOCvPsaIyp\"}],\"group\":\"cf-nel\",\"max_age\":604800}" } }, "NEL": { "style": "simple", "explode": false, "schema": { "type": "string", "example": "{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}" } }, "Server": { "style": "simple", "explode": false, "schema": { "type": "string", "example": "cloudflare" } }, "CF-RAY": { "style": "simple", "explode": false, "schema": { "type": "string", "example": "764095701ac19b9a-FRA" } }, "Content-Encoding": { "style": "simple", "explode": false, "schema": { "type": "string", "example": "br" } }, "alt-svc": { "style": "simple", "explode": false, "schema": { "type": "string", "example": "h3=\":443\"; ma=86400, h3-29=\":443\"; ma=86400" } } }, "content": { "application/json": { "schema": { "type": "object" }, "example": { "input": [ { "lon": "8.7352799", "lat": "49.2971779", "wp": "4400", "deg": "33", "az": "0", "tech": "crystSi", "err": "", "loss": "14", "plant": "0xF826125A830759CDaCc7428d97eBc0C4af849C77", "created": 1667431047719 } ], "output": [ { "date": "2022-11-01T23:00:00.000Z", "timestamp": 1667343600000, "wh": 0 }, { "date": "2022-11-02T00:00:00.000Z", "timestamp": 1667347200000, "wh": 0 }, { "date": "2022-11-02T01:00:00.000Z", "timestamp": 1667350800000, "wh": 0 }, { "date": "2022-11-02T02:00:00.000Z", "timestamp": 1667354400000, "wh": 0 }, { "date": "2022-11-02T03:00:00.000Z", "timestamp": 1667358000000, "wh": 0 }, { "date": "2022-11-02T04:00:00.000Z", "timestamp": 1667361600000, "wh": 0 }, { "date": "2022-11-02T05:00:00.000Z", "timestamp": 1667365200000, "wh": 0 }, { "date": "2022-11-02T06:00:00.000Z", "timestamp": 1667368800000, "wh": 8 }, { "date": "2022-11-02T07:00:00.000Z", "timestamp": 1667372400000, "wh": 189 }, { "date": "2022-11-02T08:00:00.000Z", "timestamp": 1667376000000, "wh": 387 }, { "date": "2022-11-02T09:00:00.000Z", "timestamp": 1667379600000, "wh": 396 }, { "date": "2022-11-02T10:00:00.000Z", "timestamp": 1667383200000, "wh": 1027 }, { "date": "2022-11-02T11:00:00.000Z", "timestamp": 1667386800000, "wh": 3251 }, { "date": "2022-11-02T12:00:00.000Z", "timestamp": 1667390400000, "wh": 1018 }, { "date": "2022-11-02T13:00:00.000Z", "timestamp": 1667394000000, "wh": 2855 }, { "date": "2022-11-02T14:00:00.000Z", "timestamp": 1667397600000, "wh": 1636 }, { "date": "2022-11-02T15:00:00.000Z", "timestamp": 1667401200000, "wh": 802 }, { "date": "2022-11-02T16:00:00.000Z", "timestamp": 1667404800000, "wh": 11 }, { "date": "2022-11-02T17:00:00.000Z", "timestamp": 1667408400000, "wh": 0 }, { "date": "2022-11-02T18:00:00.000Z", "timestamp": 1667412000000, "wh": 0 }, { "date": "2022-11-02T19:00:00.000Z", "timestamp": 1667415600000, "wh": 0 }, { "date": "2022-11-02T20:00:00.000Z", "timestamp": 1667419200000, "wh": 0 }, { "date": "2022-11-02T21:00:00.000Z", "timestamp": 1667422800000, "wh": 0 }, { "date": "2022-11-02T22:00:00.000Z", "timestamp": 1667426400000, "wh": 0 }, { "date": "2022-11-02T23:00:00.000Z", "timestamp": 1667430000000, "wh": 0 }, { "date": "2022-11-03T00:00:00.000Z", "timestamp": 1667433600000, "wh": 0 }, { "date": "2022-11-03T01:00:00.000Z", "timestamp": 1667437200000, "wh": 0 }, { "date": "2022-11-03T02:00:00.000Z", "timestamp": 1667440800000, "wh": 0 }, { "date": "2022-11-03T03:00:00.000Z", "timestamp": 1667444400000, "wh": 0 }, { "date": "2022-11-03T04:00:00.000Z", "timestamp": 1667448000000, "wh": 0 }, { "date": "2022-11-03T05:00:00.000Z", "timestamp": 1667451600000, "wh": 0 }, { "date": "2022-11-03T06:00:00.000Z", "timestamp": 1667455200000, "wh": 0 }, { "date": "2022-11-03T07:00:00.000Z", "timestamp": 1667458800000, "wh": 17 }, { "date": "2022-11-03T08:00:00.000Z", "timestamp": 1667462400000, "wh": 610 }, { "date": "2022-11-03T09:00:00.000Z", "timestamp": 1667466000000, "wh": 997 }, { "date": "2022-11-03T10:00:00.000Z", "timestamp": 1667469600000, "wh": 1611 }, { "date": "2022-11-03T11:00:00.000Z", "timestamp": 1667473200000, "wh": 1417 }, { "date": "2022-11-03T12:00:00.000Z", "timestamp": 1667476800000, "wh": 1604 }, { "date": "2022-11-03T13:00:00.000Z", "timestamp": 1667480400000, "wh": 992 }, { "date": "2022-11-03T14:00:00.000Z", "timestamp": 1667484000000, "wh": 791 }, { "date": "2022-11-03T15:00:00.000Z", "timestamp": 1667487600000, "wh": 412 }, { "date": "2022-11-03T16:00:00.000Z", "timestamp": 1667491200000, "wh": 182 }, { "date": "2022-11-03T17:00:00.000Z", "timestamp": 1667494800000, "wh": 0 }, { "date": "2022-11-03T18:00:00.000Z", "timestamp": 1667498400000, "wh": 0 }, { "date": "2022-11-03T19:00:00.000Z", "timestamp": 1667502000000, "wh": 0 }, { "date": "2022-11-03T20:00:00.000Z", "timestamp": 1667505600000, "wh": 0 }, { "date": "2022-11-03T21:00:00.000Z", "timestamp": 1667509200000, "wh": 0 }, { "date": "2022-11-03T22:00:00.000Z", "timestamp": 1667512800000, "wh": 0 }, { "date": "2022-11-03T23:00:00.000Z", "timestamp": 1667516400000, "wh": 0 }, { "date": "2022-11-04T00:00:00.000Z", "timestamp": 1667520000000, "wh": 0 }, { "date": "2022-11-04T01:00:00.000Z", "timestamp": 1667523600000, "wh": 0 }, { "date": "2022-11-04T02:00:00.000Z", "timestamp": 1667527200000, "wh": 0 }, { "date": "2022-11-04T03:00:00.000Z", "timestamp": 1667530800000, "wh": 0 }, { "date": "2022-11-04T04:00:00.000Z", "timestamp": 1667534400000, "wh": 0 }, { "date": "2022-11-04T05:00:00.000Z", "timestamp": 1667538000000, "wh": 0 }, { "date": "2022-11-04T06:00:00.000Z", "timestamp": 1667541600000, "wh": 0 }, { "date": "2022-11-04T07:00:00.000Z", "timestamp": 1667545200000, "wh": 6 }, { "date": "2022-11-04T08:00:00.000Z", "timestamp": 1667548800000, "wh": 395 }, { "date": "2022-11-04T09:00:00.000Z", "timestamp": 1667552400000, "wh": 403 }, { "date": "2022-11-04T10:00:00.000Z", "timestamp": 1667556000000, "wh": 220 }, { "date": "2022-11-04T11:00:00.000Z", "timestamp": 1667559600000, "wh": 211 }, { "date": "2022-11-04T12:00:00.000Z", "timestamp": 1667563200000, "wh": 411 }, { "date": "2022-11-04T13:00:00.000Z", "timestamp": 1667566800000, "wh": 1030 }, { "date": "2022-11-04T14:00:00.000Z", "timestamp": 1667570400000, "wh": 1219 }, { "date": "2022-11-04T15:00:00.000Z", "timestamp": 1667574000000, "wh": 626 }, { "date": "2022-11-04T16:00:00.000Z", "timestamp": 1667577600000, "wh": 195 }, { "date": "2022-11-04T17:00:00.000Z", "timestamp": 1667581200000, "wh": 0 }, { "date": "2022-11-04T18:00:00.000Z", "timestamp": 1667584800000, "wh": 0 }, { "date": "2022-11-04T19:00:00.000Z", "timestamp": 1667588400000, "wh": 0 }, { "date": "2022-11-04T20:00:00.000Z", "timestamp": 1667592000000, "wh": 0 }, { "date": "2022-11-04T21:00:00.000Z", "timestamp": 1667595600000, "wh": 0 }, { "date": "2022-11-04T22:00:00.000Z", "timestamp": 1667599200000, "wh": 0 }, { "date": "2022-11-04T23:00:00.000Z", "timestamp": 1667602800000, "wh": 0 }, { "date": "2022-11-05T00:00:00.000Z", "timestamp": 1667606400000, "wh": 0 }, { "date": "2022-11-05T01:00:00.000Z", "timestamp": 1667610000000, "wh": 0 }, { "date": "2022-11-05T02:00:00.000Z", "timestamp": 1667613600000, "wh": 0 }, { "date": "2022-11-05T03:00:00.000Z", "timestamp": 1667617200000, "wh": 0 }, { "date": "2022-11-05T04:00:00.000Z", "timestamp": 1667620800000, "wh": 0 }, { "date": "2022-11-05T05:00:00.000Z", "timestamp": 1667624400000, "wh": 0 }, { "date": "2022-11-05T06:00:00.000Z", "timestamp": 1667628000000, "wh": 0 }, { "date": "2022-11-05T07:00:00.000Z", "timestamp": 1667631600000, "wh": 17 }, { "date": "2022-11-05T08:00:00.000Z", "timestamp": 1667635200000, "wh": 791 }, { "date": "2022-11-05T09:00:00.000Z", "timestamp": 1667638800000, "wh": 1615 }, { "date": "2022-11-05T10:00:00.000Z", "timestamp": 1667642400000, "wh": 2245 }, { "date": "2022-11-05T11:00:00.000Z", "timestamp": 1667646000000, "wh": 2652 }, { "date": "2022-11-05T12:00:00.000Z", "timestamp": 1667649600000, "wh": 2826 }, { "date": "2022-11-05T13:00:00.000Z", "timestamp": 1667653200000, "wh": 2444 }, { "date": "2022-11-05T14:00:00.000Z", "timestamp": 1667656800000, "wh": 1826 }, { "date": "2022-11-05T15:00:00.000Z", "timestamp": 1667660400000, "wh": 999 }, { "date": "2022-11-05T16:00:00.000Z", "timestamp": 1667664000000, "wh": 200 }, { "date": "2022-11-05T17:00:00.000Z", "timestamp": 1667667600000, "wh": 0 }, { "date": "2022-11-05T18:00:00.000Z", "timestamp": 1667671200000, "wh": 0 }, { "date": "2022-11-05T19:00:00.000Z", "timestamp": 1667674800000, "wh": 0 }, { "date": "2022-11-05T20:00:00.000Z", "timestamp": 1667678400000, "wh": 0 }, { "date": "2022-11-05T21:00:00.000Z", "timestamp": 1667682000000, "wh": 0 }, { "date": "2022-11-05T22:00:00.000Z", "timestamp": 1667685600000, "wh": 0 }, { "date": "2022-11-05T23:00:00.000Z", "timestamp": 1667689200000, "wh": 0 }, { "date": "2022-11-06T00:00:00.000Z", "timestamp": 1667692800000, "wh": 0 }, { "date": "2022-11-06T01:00:00.000Z", "timestamp": 1667696400000, "wh": 0 }, { "date": "2022-11-06T02:00:00.000Z", "timestamp": 1667700000000, "wh": 0 }, { "date": "2022-11-06T03:00:00.000Z", "timestamp": 1667703600000, "wh": 0 }, { "date": "2022-11-06T04:00:00.000Z", "timestamp": 1667707200000, "wh": 0 }, { "date": "2022-11-06T05:00:00.000Z", "timestamp": 1667710800000, "wh": 0 }, { "date": "2022-11-06T06:00:00.000Z", "timestamp": 1667714400000, "wh": 0 }, { "date": "2022-11-06T07:00:00.000Z", "timestamp": 1667718000000, "wh": 16 }, { "date": "2022-11-06T08:00:00.000Z", "timestamp": 1667721600000, "wh": 615 }, { "date": "2022-11-06T09:00:00.000Z", "timestamp": 1667725200000, "wh": 1626 }, { "date": "2022-11-06T10:00:00.000Z", "timestamp": 1667728800000, "wh": 2210 }, { "date": "2022-11-06T11:00:00.000Z", "timestamp": 1667732400000, "wh": 2414 }, { "date": "2022-11-06T12:00:00.000Z", "timestamp": 1667736000000, "wh": 2427 }, { "date": "2022-11-06T13:00:00.000Z", "timestamp": 1667739600000, "wh": 2419 }, { "date": "2022-11-06T14:00:00.000Z", "timestamp": 1667743200000, "wh": 1637 }, { "date": "2022-11-06T15:00:00.000Z", "timestamp": 1667746800000, "wh": 821 }, { "date": "2022-11-06T16:00:00.000Z", "timestamp": 1667750400000, "wh": 184 }, { "date": "2022-11-06T17:00:00.000Z", "timestamp": 1667754000000, "wh": 0 }, { "date": "2022-11-06T18:00:00.000Z", "timestamp": 1667757600000, "wh": 0 }, { "date": "2022-11-06T19:00:00.000Z", "timestamp": 1667761200000, "wh": 0 }, { "date": "2022-11-06T20:00:00.000Z", "timestamp": 1667764800000, "wh": 0 }, { "date": "2022-11-06T21:00:00.000Z", "timestamp": 1667768400000, "wh": 0 }, { "date": "2022-11-06T22:00:00.000Z", "timestamp": 1667772000000, "wh": 0 } ] } } } } } } }, "/v2.0/solar/estimation": { "get": { "tags": [ "default" ], "summary": "Ertragsprognose", "parameters": [ { "name": "lon", "in": "query", "description": "Geo-Koordinate der Anlage - Längengrad", "required": false, "style": "form", "explode": true, "schema": { "type": "number" }, "example": "8.7352799" }, { "name": "lat", "in": "query", "description": "Geo-Koordinate der Anlage - Breitengrad", "required": false, "style": "form", "explode": true, "schema": { "type": "number" }, "example": "49.2971779" }, { "name": "wp", "in": "query", "description": "Watt Peak der Anlage für die eine Ertragsprognose erstellt werden soll (kWp/1000)", "required": false, "style": "form", "explode": true, "schema": { "type": "integer" }, "example": "4400" }, { "name": "deg", "in": "query", "description": "Anstellwinkel der Anlage", "required": false, "style": "form", "explode": true, "schema": { "type": "integer" }, "example": "33" }, { "name": "az", "in": "query", "description": "Ausrichtung der Anlage nach Süden (West = 90°, Ost = -90°)\n", "required": false, "style": "form", "explode": true, "schema": { "type": "integer" }, "example": "0" } ], "responses": { "200": { "description": "OK", "headers": { "Date": { "style": "simple", "explode": false, "schema": { "type": "string", "example": "Wed, 02 Nov 2022 23:24:26 GMT" } }, "Content-Type": { "style": "simple", "explode": false, "schema": { "type": "string", "example": "application/json; charset=utf-8" } }, "Transfer-Encoding": { "style": "simple", "explode": false, "schema": { "type": "string", "example": "chunked" } }, "Connection": { "style": "simple", "explode": false, "schema": { "type": "string", "example": "keep-alive" } }, "x-request-id": { "style": "simple", "explode": false, "schema": { "type": "string", "example": "a43fba9d-6edc-4e06-94b1-a851a0cac107" } }, "x-rate-limit-limit": { "style": "simple", "explode": false, "schema": { "type": "integer", "example": 30 } }, "x-rate-limit-remaining": { "style": "simple", "explode": false, "schema": { "type": "integer", "example": 29 } }, "x-rate-limit-reset": { "style": "simple", "explode": false, "schema": { "type": "integer", "example": 1667431482626 } }, "x-request-compute": { "style": "simple", "explode": false, "schema": { "type": "integer", "example": 306 } }, "x-request-transfer": { "style": "simple", "explode": false, "schema": { "type": "integer", "example": 413 } }, "x-sessioncredit-compute": { "style": "simple", "explode": false, "schema": { "type": "integer", "example": 89999983373 } }, "x-sessioncredit-transfer": { "style": "simple", "explode": false, "schema": { "type": "number", "example": -193701 } }, "x-sessioncredit-start": { "style": "simple", "explode": false, "schema": { "type": "integer", "example": 1667428543550 } }, "access-control-allow-origin": { "style": "simple", "explode": false, "schema": { "type": "string", "example": "*" } }, "etag": { "style": "simple", "explode": false, "schema": { "type": "string", "example": "W/\"19d-Licksc64I7LaNcf8u+sZkBu87vI\"" } }, "x-served-by": { "style": "simple", "explode": false, "schema": { "type": "string", "example": "api.corrently.io" } }, "CF-Cache-Status": { "style": "simple", "explode": false, "schema": { "type": "string", "example": "DYNAMIC" } }, "Report-To": { "style": "simple", "explode": false, "schema": { "type": "string", "example": "{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v3?s=EtTnAZ1RqdSxpP22WCNWXyO2UJxUaz5yxQOwKtNxvXvudn%2BSJ%2F9ESLdou7pZG%2B%2B8Ay%2BV619urEICsB1u%2F6PzAz7nq7Fmb7pOylMYNm9Rm2ShP5MBKhUTR19w8ew8wTlWCyeR\"}],\"group\":\"cf-nel\",\"max_age\":604800}" } }, "NEL": { "style": "simple", "explode": false, "schema": { "type": "string", "example": "{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}" } }, "Server": { "style": "simple", "explode": false, "schema": { "type": "string", "example": "cloudflare" } }, "CF-RAY": { "style": "simple", "explode": false, "schema": { "type": "string", "example": "76409fa6db419b9a-FRA" } }, "Content-Encoding": { "style": "simple", "explode": false, "schema": { "type": "string", "example": "br" } }, "alt-svc": { "style": "simple", "explode": false, "schema": { "type": "string", "example": "h3=\":443\"; ma=86400, h3-29=\":443\"; ma=86400" } } }, "content": { "application/json": { "schema": { "type": "object" }, "example": { "inputs": { "lon": "8.7352799", "lat": "49.2971779", "wp": "4400", "deg": "33", "az": "0", "loss": "14", "tech": "crystSi" }, "outputs": [ { "month": 1, "wh": 168020 }, { "month": 2, "wh": 248700 }, { "month": 3, "wh": 407590 }, { "month": 4, "wh": 541870 }, { "month": 5, "wh": 559570 }, { "month": 6, "wh": 569990 }, { "month": 7, "wh": 575450 }, { "month": 8, "wh": 539330 }, { "month": 9, "wh": 457800 }, { "month": 10, "wh": 326980 }, { "month": 11, "wh": 197160 }, { "month": 12, "wh": 146340 } ] } } } } } } } }, "components": {} }