Programmatischer Zugriff auf Feld-Bodenwerte und -Geometrien. Server-zu-Server gedacht (kein Browser-Einsatz — der Schlüssel gehört nicht in Client-Code). Schlüssel verwalten Sie unter Mein Konto → API-Schlüssel. Voraussetzung: aktiver Jahreszugang.
Jede Anfrage braucht den Header X-API-Key:
curl -H "X-API-Key: fbw_live_…" https://flaechenbewertung.xsupra.io/v1/field/DEST0500010006
Der Schlüssel wird nur einmal bei der Erstellung angezeigt; gespeichert wird serverseitig nur sein Hash. Verloren = neuen erstellen.
GET /v1/field/{flik}
Feld-Steckbrief per FLIK (16-stellig; NI-Langform wird normalisiert).
curl -H "X-API-Key: …" https://flaechenbewertung.xsupra.io/v1/field/DEST0500740048
GET /v1/field?lat=&lon=
Feld am Punkt (WGS84).
curl -H "X-API-Key: …" "https://flaechenbewertung.xsupra.io/v1/field?lat=51.62&lon=11.78"
GET /v1/field/{flik}/geometry
Feld-Umriss als GeoJSON-Feature (inkl. bbox).
curl -H "X-API-Key: …" https://flaechenbewertung.xsupra.io/v1/field/DEST0500740048/geometry
| Feld | Bedeutung |
|---|---|
flik | Feldblock-Identifikator |
area_m2 | Fläche in m² |
bodenwert_eur | geschätzter Bodenwert (€) |
eur_per_ha | Kapitalwert €/ha |
brw_adjusted / brw_ref | angepasster / Referenz-Bodenrichtwert €/m² |
acza_ref / az_individuell | Referenz- / parzellenscharfe Ackerzahl |
score / ampel | Standortqualität 0–1 / Ampel |
confidence | Daten-Konfidenz 0–1 |
brw_stichtag | BRW-Stichtag (ISO) |
fruchtfolge | Kulturen je Jahr (Thünen) |
pluspunkte/risiken/hinweise | Standortfaktoren |
Limit: 60 Anfragen / Minute je Schlüssel (sonst 429 mit
Retry-After).
| Code | Bedeutung |
|---|---|
| 200 | OK |
| 401 | Schlüssel fehlt oder ungültig |
| 402 | Abo abgelaufen — Zugriff pausiert |
| 404 | FLIK/Feld unbekannt |
| 429 | Rate-Limit überschritten |
Interaktive Schema-Ansicht: /docs (OpenAPI/Swagger). Werte sind abgeleitete Schätzungen, kein amtlicher Bodenrichtwert.