API-Einrichtung – Integration der WFS in eigene Systeme

Wenn Sie die Wildfire Solution (WFS) in Ihr eigenes System integrieren möchten, benötigen Sie einen API-Schlüssel.
Dazu ist ein gültiges Abonnement erforderlich.
📩 Kontaktieren Sie unser Team für weitere Informationen: support@ororatech.com

Zugriffsmöglichkeiten auf WFS-Daten

Alle in der WFS verfügbaren Daten sind sowohl über die Web-App als auch über die API zugänglich.

Die API bietet direkten Zugriff auf Daten und Funktionen der Plattform und ist der empfohlene Weg, um WFS in bestehende Systeme zu integrieren.

Einführung

Für jede API-Anfrage wird ein API-Schlüssel benötigt, der im Header der Anfrage unter dem Parameter apikey mitgesendet wird.

Die Pull-basierte API der Wildfire Solution umfasst eine Reihe von HTTPS-REST-Endpunkten, mit denen Sie:

Daten zu aktuellen und historischen Bränden abrufen können
Informationen zu verbrannten Flächen einsehen
Fire Spread Simulationen ausführen
Satellitenbilder von OroraTech-Satelliten anfordern
Satellitenprodukte abfragen

Um die API zu verwenden, benötigen Sie:

ein aktives Abonnement
einen gültigen API-Schlüssel
einen REST-Client zur Abfrage der Daten

Autorisierung

Die Autorisierung erfolgt über persönliche API-Schlüssel.
Nutzer*innen mit gültigem Abonnement können den Schlüssel unter:
„Account → Profile“ selbst generieren.

apisc

Nach der Erzeugung eines Schlüssels muss dieser an einem sicheren Ort aufbewahrt werden. Es ist nicht möglich, den Schlüssel auf der Plattform wieder einzusehen. Wenn ein Schlüssel verloren geht, muss der alte Schlüssel gelöscht und ein neuer Schlüssel erzeugt werden. Gelöschte Schlüssel werden widerrufen und funktionieren sofort nicht mehr.

Alle Anfragen an die API müssen diesen Schlüssel in einem apikey -Header enthalten, zum Beispiel:

curl --request GET \
  --url "https://app.ororatech.com/v1/monitored_areas/my/clusters/" \
  --header "apikey: ot_1234567890abcdef.1234567890aBCDef"

💡 Der API-Schlüssel wird deaktiviert, sobald das Abonnement abläuft.
Wird das Abonnement erneut aktiviert, kann derselbe Schlüssel wieder verwendet werden.

🔒 Empfehlung: Automatisierte API-Abfragen stoppen, wenn das Abonnement ausläuft – um unnötige Anfragen und eine Blockierung zu vermeiden.

Einschränkungen

Abhängig vom Abonnement-Typ können:

unterschiedliche API-Funktionen verfügbar sein
unterschiedliche Abfragebegrenzungen (Rate Limits) gelten
nur bestimmte Zeitfenster von Daten zugänglich sein (z. B. nur Feuerdaten eines bestimmten Jahres)

Im Abschnitt Integrationsleitfäden finden Sie weitere Informationen darüber, wie oft eine API abgefragt werden sollte, um Daten effektiv abzurufen, ohne die API zu überlasten.

Technische Spezifikation

Die API-Spezifikation wird optional als Swagger-Datei bereitgestellt.
Diese Datei kann zur automatischen Generierung von Client-Code in verschiedenen Programmiersprachen genutzt werden.

🧩 Swagger-Datei URL:
https://app.ororatech.com/v1/api/swagger.json

Unter diesem Link finden Sie die gesamte REST-API-Dokumentation für die weitere Datenextraktion in den Bereichen Feuer, verbrannte Flächen, integrierte Vorfälle, Brandausbreitung und viele andere Themen.