API-Zugang
Integrieren Sie PV-Ertragsberechnungen und Wirtschaftlichkeitsanalysen direkt in Ihre Anwendung. Nutzungsbasierte Preisgestaltung mit kostenlosem Einstieg.
Authentifizierung
Alle API-Anfragen erfordern einen gültigen API-Key im Authorization-Header. API-Keys werden im Dashboard erstellt und verwaltet.
Sandbox-Umgebung: Verwenden Sie Keys mit dem Prefix sk_test_ für die Sandbox. Sandbox-Anfragen geben realistische Mock-Daten zurück und werden nicht berechnet.
Base URL
Endpunkte
Berechnet den jährlichen PV-Ertrag basierend auf Standort, Dachkonfiguration und Modultyp.
Request Body
{
"location": {
"postalCode": "string",
"country": "'DE' | 'AT' | 'CH'"
},
"roof": {
"area": "number (m²)",
"tilt": "number (°)",
"azimuth": "number (°)",
"shading": "number (%)"
},
"system": {
"modulePower": "number (Wp)",
"moduleType": "'mono' | 'poly' | 'thin-film'"
}
}Response
{
"systemPower": "number (kWp)",
"moduleCount": "number",
"annualYield": "number (kWh)",
"specificYield": "number (kWh/kWp)",
"monthlyYield": "Array<{ month: string, yield: number }>"
}Fehlerbehandlung
Die API verwendet Standard-HTTP-Statuscodes. Fehler werden als JSON zurückgegeben.
| Status | Bedeutung | Beschreibung |
|---|---|---|
| 200 | OK | Anfrage erfolgreich |
| 400 | Bad Request | Ungültige Parameter |
| 401 | Unauthorized | Ungültiger oder fehlender API-Key |
| 403 | Forbidden | API-Key deaktiviert |
| 429 | Too Many Requests | Rate Limit überschritten |
| 500 | Server Error | Interner Fehler |
Rate Limiting
Anfragen werden pro API-Key und Abrechnungsperiode (monatlich) gezählt. Zusätzlich gilt ein Minutenlimit zum Schutz vor Missbrauch.
| Tier | Requests/Monat | Requests/Minute |
|---|---|---|
| Free | 100 | 5 |
| Starter | 1.000 | 20 |
| Professional | 10.000 | 60 |
| Enterprise | 100.000 | 200 |
Uptime SLA
| Tier | SLA | Support |
|---|---|---|
| Free | Best Effort | Community |
| Starter | 99,5 % | E-Mail (48h) |
| Professional | 99,9 % | E-Mail (24h) |
| Enterprise | 99,95 % | Dedizierter Support |
Kontakt & Support
Für API-spezifische Fragen oder Enterprise-Anfragen kontaktieren Sie uns unter api@solantiq.example.com.
Die API-Dokumentation wird regelmäßig aktualisiert. Bei Breaking Changes informieren wir alle API-Nutzer mindestens 30 Tage im Voraus per E-Mail.