Ρύθμιση API (Διεπαφές Προγραμματισμού Εφαρμογών)

Συνδέστε την πλατφόρμα WFS με το δικό σας σύστημα μέσω API

📌 API Key & Συνδρομή

Για να ενσωματώσετε την πλατφόρμα WFS στο δικό σας σύστημα, απαιτείται API Key.
Για να λάβετε το κλειδί, απαιτείται ενεργή συνδρομή.
📧 Επικοινωνήστε με την ομάδα μας στο support@ororatech.com για περισσότερες πληροφορίες.

🔍 Πρόσβαση Δεδομένων

Όλα τα δεδομένα που είναι διαθέσιμα μέσω της πλατφόρμας WFS μπορούν να προσπελαστούν:

Μέσω Web App
Ή μέσω API

Το API παρέχει άμεση πρόσβαση στα δεδομένα και τις λειτουργίες της πλατφόρμας και είναι ο προτεινόμενος τρόπος για ενσωμάτωση με υπάρχοντα συστήματα.

🚀 Εισαγωγή στη Λειτουργία του API

Για κάθε λειτουργία API απαιτείται API Key, το οποίο συμπεριλαμβάνεται στο header του αιτήματος ως apikey.

Το pull-based API περιλαμβάνει HTTPS REST endpoints που επιτρέπουν:

Ανάκτηση δεδομένων για ενεργές & ιστορικές πυρκαγιές
Δεδομένα για καμένες περιοχές
Εκτέλεση προσομοιώσεων εξάπλωσης πυρκαγιάς
Ανάθεση εικόνων από δορυφόρους OroraTech
Αναζήτηση προϊόντων δορυφόρου

📌 Για χρήση του API χρειάζεστε:

Ενεργή συνδρομή
API key
REST client (π.χ. Postman, curl) για υποβολή αιτημάτων

🔐 Εξουσιοδότηση (Authorization)

Η εξουσιοδότηση στο API γίνεται μέσω προσωπικών API Keys.

🧭 Οι συνδεδεμένοι χρήστες με ενεργή συνδρομή μπορούν να δημιουργήσουν API Key από:
Account → Profile

apisc

📁 Σημαντικές Σημειώσεις για API Keys

Το κλειδί πρέπει να αποθηκευτεί με ασφάλεια — δεν θα εμφανιστεί ξανά
Αν χαθεί, πρέπει να διαγραφεί και να δημιουργηθεί νέο
Διαγραμμένα κλειδιά ακυρώνονται άμεσα
Το apikey τοποθετείται στο header κάθε αιτήματος, π.χ.:

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

📌 Το API Key σταματά να λειτουργεί αν λήξει η συνδρομή, αλλά δεν διαγράφεται.
Εφόσον η συνδρομή ανανεωθεί, το ίδιο κλειδί μπορεί να χρησιμοποιηθεί ξανά.

✅ Συνιστάται να διακόπτετε αυτόματες εργασίες όταν πλησιάζει η λήξη της συνδρομής για να αποφευχθεί υπερφόρτωση ή αποκλεισμός.

⛔ Περιορισμοί

Ανάλογα με το συνδρομητικό πακέτο:

Ενδέχεται να υπάρχουν διαφορετικά όρια (rate limits)
Η πρόσβαση μπορεί να περιορίζεται σε συγκεκριμένο χρονικό διάστημα (π.χ. μόνο για ένα έτος)

📩 Επικοινωνήστε με τον αρμόδιο συνεργάτη πωλήσεων για περισσότερες λεπτομέρειες.

🔗 https://app.ororatech.com/docs/guides/use-cases/

📖 Τεχνικές Προδιαγραφές & Τεκμηρίωση

Η τεκμηρίωση του REST API είναι διαθέσιμη σε μορφή Swagger file, το οποίο μπορεί να χρησιμοποιηθεί για αυτόματη δημιουργία client κώδικα.

🔗 https://app.ororatech.com/v1/api/swagger.json

📚 Εκεί θα βρείτε όλα τα endpoints για:

Fires
Burnt Areas
Integrated Incidents
Fire Spread
Και πολλά άλλα

🔗 https://app.ororatech.com/docs/api/