Cyanoware API Dokumentation

Integrieren Sie unsere Satellitendaten nahtlos in Ihre eigenen Applikationen.

Authentifizierung

Die Cyanoware API verwendet API Keys zur Authentifizierung. Senden Sie Ihren API Key im X-API-Key Header Ihres HTTP Requests.

curl -X GET 'https://cyanoware.com/api/v1/cyanoware/lakes' \
  -H 'X-API-Key: IHR_API_KEY'

Rate Limits

Um Missbrauch vorzubeugen, sind Anfragen an die API limitiert:

  • Stats Endpoint: 30 Requests pro Minute pro IP.
  • Lakes Endpoint: 60 Requests pro Minute pro IP.
  • Status Endpoint: 120 Requests pro Minute pro IP.

Bei Überschreitung wird der Statuscode 429 Too Many Requests zurĂŒckgegeben.

Endpunkte

Get/api/v1/cyanoware/lakes

Gibt eine paginierte Liste aller offiziell im System erfassten Seen zurĂŒck.

Query Parameter

ParameterTypBeschreibung
limitintegerOptional. Anzahl der Seen (Standard 50, Max 5000).
offsetintegerOptional. Paginierung.

Response Object

FeldTypBeschreibung
external_idstringEinzigartige ID des Sees.
namestringOffizieller Name des GewÀssers.
latitude / longitudefloatZentrums-Koordinaten (Latitude / Longitude).