Configuration des API

Si vous souhaitez intégrer WFS à votre propre système, une clé API est nécessaire. Pour cela, un abonnement valide est requis.
👉 Contactez notre équipe pour plus d’informations: support@ororatech.com

Toutes les données présentes dans WFS sont accessibles via l’application Web ou via l’API.

L’API permet un accès direct aux données et aux fonctionnalités de la plateforme, et constitue la méthode recommandée pour intégrer la solution dans des systèmes existants.

Introduction

Pour toute opération via l’API, une clé API est nécessaire. Elle doit être incluse dans l’en-tête de la requête sous la forme : apikey.

L’API proposée dans le cadre de la Wildfire Solution est une API REST en HTTPS (basée sur le modèle "pull"). Elle permet aux utilisateurs de :

Récupérer les données des incendies actifs et historiques
Accéder aux données des zones brûlées
Lancer des simulations de propagation du feu
Planifier des images avec les satellites d’OroraTech
Interroger les produits satellitaires

Pour utiliser l’API, les utilisateurs doivent disposer :

D’un abonnement actif
D’une clé API personnelle
D’un client REST pour interroger le serveur

Le serveur traite les requêtes et renvoie les données selon les paramètres spécifiés.

Authentification

L’autorisation d’accès à l’API se fait par clé API personnelle.
Les utilisateurs connectés avec un abonnement valide peuvent générer une clé depuis "Compte → Profil".

apisc

Une fois la clé générée, elle doit être conservée en lieu sûr, car elle ne sera plus affichée.
Si vous perdez votre clé, vous devrez supprimer l’ancienne et en créer une nouvelle.
Les clés supprimées sont immédiatement révoquées et ne fonctionneront plus.

Toutes les requêtes API doivent inclure cette clé dans l’en-tête apikey, par exemple :

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

Les clés API cessent de fonctionner à l’expiration de l’abonnement, mais ne sont pas automatiquement supprimées.

👉 Si l’abonnement est renouvelé, la même clé pourra être réutilisée.

💡 Il est recommandé d’arrêter les tâches automatisées à l’approche de l’expiration d’un abonnement pour éviter les requêtes inutiles et le blocage de la clé.

Limitations

Selon le type d’abonnement, les utilisateurs peuvent avoir accès à différentes fonctionnalités et être soumis à des limitations de requêtes.
Dans certains cas, seules certaines périodes de données sont disponibles (ex. : données d’incendies d’une année spécifique).

👉 Contactez votre interlocuteur commercial pour plus d’informations sur les fonctionnalités disponibles et les limitations.

Consultez la section Guides d’intégration pour savoir à quelle fréquence interroger l’API et éviter une utilisation excessive.

Spécification

La spécification de l’API REST est également proposée au format Swagger.
Ce fichier peut être utilisé pour générer du code client dans plusieurs langages de programmation.

📎 Fichier Swagger disponible ici :
https://app.ororatech.com/v1/api/swagger.json

Dans ce lien, vous trouverez toute la documentation de l’API REST, pour extraire des données liées aux incendies, zones brûlées, incidents intégrés, propagation du feu, et bien plus encore.