API Playground — Biodiversitäts-Datenservice

Interaktiver API-Explorer für den Biodiversitäts-Datenservice Sachsen-Anhalt. Alle Endpunkte simulieren reale Antworten mit echten Artendaten. Es werden keine Daten an einen Server gesendet — die Antworten werden clientseitig erzeugt.

Base URL https://workflow-now.de/biodiv-api

GET /species

GET /species/{id}

GET /observations

GET /statistics

GET /redlist

GET /species

Arten abfragen mit optionalen Filtern nach Familie, Ordnung, Schutzstatus und Region.

Parameter

family string Taxonomische Familie

order string Taxonomische Ordnung

redlist string

region string

limit integer Max. Ergebnisse (1–100)

offset integer Ergebnisse überspringen

Antwort-Schema: Species

Feld	Typ	Beschreibung
id	string	Eindeutige Art-ID (UUID-Format)
scientific_name	string	Wissenschaftlicher Artname (binomial)
common_name	string	Deutscher Trivialname
family	string	Taxonomische Familie
order	string	Taxonomische Ordnung
redlist_status	string	Rote-Liste-Kategorie (CR, EN, VU, NT, LC)
observation_count	integer	Anzahl erfasster Beobachtungen
last_observed	string	Letztes Beobachtungsdatum (ISO 8601)

GET /species/{id}

Einzelne Art mit vollständigen Details abrufen, inkl. Koordinaten des letzten Nachweises.

Parameter

id string, erforderlich Art-ID auswählen

Antwort-Schema: Species Detail

Feld	Typ	Beschreibung
id	string	Eindeutige Art-ID
scientific_name	string	Wissenschaftlicher Artname
common_name	string	Deutscher Trivialname
family	string	Taxonomische Familie
order	string	Taxonomische Ordnung
class	string	Taxonomische Klasse
redlist_status	string	Rote-Liste-Kategorie
protection	string	Schutzstatus (streng geschützt, besonders geschützt)
habitat	string	Bevorzugter Lebensraum
observation_count	integer	Gesamtzahl Beobachtungen
last_observed	string	Letztes Beobachtungsdatum (ISO 8601)
last_location	object	GeoJSON Point — Koordinaten des letzten Nachweises

GET /observations

Beobachtungen abfragen, filterbar nach Art, Zeitraum und Region. Enthält GeoJSON-Koordinaten.

Parameter

species_id string

region string

year_from integer

year_to integer

limit integer

offset integer

Antwort-Schema: Observation

Feld	Typ	Beschreibung
id	string	Beobachtungs-ID
species_id	string	Referenz auf Art-ID
species_name	string	Wissenschaftlicher Artname
common_name	string	Deutscher Trivialname
observed_at	string	Beobachtungszeitpunkt (ISO 8601)
location	object	GeoJSON Point (lon, lat)
locality	string	Ortsbezeichnung
observer	string	Beobachter (anonymisiert)
count	integer	Anzahl gesichteter Individuen

GET /statistics

Aggregierte Statistiken: Artenzahlen, Beobachtungen, Rote-Liste-Verteilung.

Parameter

region string

year integer

Antwort-Schema: Statistics

Feld	Typ	Beschreibung
total_species	integer	Gesamtzahl erfasster Arten
total_observations	integer	Gesamtzahl Beobachtungen
observers_active	integer	Aktive Melder im Zeitraum
redlist_distribution	object	Verteilung nach Rote-Liste-Kategorie
top_observed	array	Die 5 am häufigsten beobachteten Arten
observations_by_month	object	Beobachtungen nach Monat

GET /redlist

Rote-Liste-Status aller erfassten Arten. Filterbar nach Kategorie und taxonomischer Klasse.

Parameter

category string

class string

Antwort-Schema: Redlist Entry

Feld	Typ	Beschreibung
species_id	string	Referenz auf Art-ID
scientific_name	string	Wissenschaftlicher Artname
common_name	string	Deutscher Trivialname
class	string	Taxonomische Klasse
category	string	Rote-Liste-Kategorie
trend	string	Bestandstrend (stable, declining, increasing)
assessed_year	integer	Jahr der letzten Bewertung

Python / FastAPI PostgreSQL / PostGIS REST / JSON OpenAPI 3.0 GeoJSON OAuth 2.0

API Playground — Biodiversitäts-Datenservice DEMO

Parameter

Antwort-Schema: Species

Parameter

Antwort-Schema: Species Detail

Parameter

Antwort-Schema: Observation

Parameter

Antwort-Schema: Statistics

Parameter

Antwort-Schema: Redlist Entry