API de GISFirePro

Cada cuenta de GISFire Pro puede crear una o varias claves API para consultar sus datos por programa: detecciones en sus zonas, ajustes, alertas enviadas, balances e historial. Esta página documenta los puntos de entrada que existen hoy; ninguno se promete para más adelante.

Autenticación

Cada solicitud lleva una cabecera Authorization con una clave con forma gfp_ seguida de caracteres hexadecimales. Las claves se crean, se nombran y se revocan desde el espacio de suscriptor, sin límite por cuenta.

Una clave da acceso a los datos de la cuenta que la creó, nunca a los de otro suscriptor. Una clave comprometida debe revocarse desde el espacio de suscriptor: borrarla de un archivo de configuración no basta si se ha filtrado.

Authorization: Bearer gfp_...

Puntos de entrada

GET/api/pro/export

Las detecciones dentro de sus zonas, en GeoJSON o CSV.

Devuelve las detecciones satelitales caídas dentro de sus zonas vigiladas en la ventana solicitada. Esta exportación está limitada a sus zonas: el dato mundial sigue siendo cosa del mapa público y de NASA FIRMS.

format
«geojson» (por defecto) o «csv».
heures
Ventana en horas, de 1 a 168 (7 días). 24 por defecto.

Una FeatureCollection GeoJSON de puntos (posición, fecha de adquisición, FRP, satélite, fuente, zona), o un archivo CSV equivalente. Limitado a 50 000 filas; por encima, reduzca la ventana.

curl -H "Authorization: Bearer gfp_..." \
  "https://gisfire.saro.app/api/pro/export?format=csv&heures=48"
GET/api/pro/zones

La lista de sus zonas vigiladas.

Sin parámetro, devuelve el inventario de sus zonas (nombre, superficie, ajustes de alerta). Con `format=geojson`, devuelve la FeatureCollection completa de las huellas, la misma que carga el espacio de suscriptor y un SIG.

format
«geojson» para la FeatureCollection completa de las huellas.

Un array de zonas ({ id, nombre, surfaceKm2, ajustes de alerta, última alerta}), o una FeatureCollection GeoJSON cuando `format=geojson`.

curl -H "Authorization: Bearer gfp_..." \
  "https://gisfire.saro.app/api/pro/zones"
POST/api/pro/zones

Crear una zona.

Crea una zona a partir de un Polygon o MultiPolygon GeoJSON en coordenadas geográficas (EPSG:4326). La superficie está limitada a 25 000 km², el orden de magnitud de un gran departamento francés: por encima, deja de ser un sitio que vigilar para convertirse en una recolección de datos, a la que sirve mejor la exportación por huella.

name
El nombre de la zona (cuerpo JSON).
geometry
Un Polygon o MultiPolygon GeoJSON, EPSG:4326 (cuerpo JSON).

La zona creada, con su identificador, como 201 Created.

curl -X POST -H "Authorization: Bearer gfp_..." -H "Content-Type: application/json" \
  -d '{"name":"Sector este","geometry":{"type":"Polygon","coordinates":[[...]]}}' \
  "https://gisfire.saro.app/api/pro/zones"
GET/api/pro/alertes

El registro de alertas y avisos enviados.

Devuelve el registro de la cuenta: alertas de detección por zona y avisos personales de humo o rayos, juntos, ordenados por fecha. Útil para resincronizarse tras un webhook fallido.

limite
Número máximo de entradas, de 1 a 500. 100 por defecto.

Un array de entradas ({ type: feu | fumee | foudre, zona, período, detecciones, FRP máximo, envíos por correo/webhook/SMS, fecha }).

curl -H "Authorization: Bearer gfp_..." \
  "https://gisfire.saro.app/api/pro/alertes?limite=50"
GET/api/pro/bilan

El balance de la cuenta en un período.

El balance completo en una ventana: alertas recibidas, incendios archivados alrededor de sus zonas, serie mensual, exposición zona por zona, medios aéreos desplegados. Es la base del resumen mensual enviado por correo.

periode
«30j», «saison», «12m» o «tout».
debut
Fecha de inicio AAAA-MM-DD, para una ventana libre (prevalece sobre periode).
fin
Fecha de fin AAAA-MM-DD, incluida.
zones
Identificadores de zonas separados por comas; si no se indica, todas las zonas.
detail
«0» para omitir el registro y la línea de tiempo detallados.

Un objeto con el balance del período, más el registro de inicios, la línea de tiempo, los tiempos de alerta y el resumen de medios aéreos cuando `detail` no es 0.

curl -H "Authorization: Bearer gfp_..." \
  "https://gisfire.saro.app/api/pro/bilan?periode=saison"
GET/api/pro/historique

Dónde arde más, a lo largo del tiempo.

Clasificaciones por departamento francés y por municipio en un período, y los focos archivados como puntos para un mapa. Sirve para medir la frecuencia de retorno del fuego alrededor de un sitio.

periode
«30j», «saison», «12m» o «tout».
debut
Fecha de inicio AAAA-MM-DD, para una ventana libre.
fin
Fecha de fin AAAA-MM-DD, incluida.

Un objeto { periode, classements, foyers }.

curl -H "Authorization: Bearer gfp_..." \
  "https://gisfire.saro.app/api/pro/historique?periode=12m"
GET/api/pro/alertes/cap

Su registro de alertas en formato CAP 1.2.

El mismo registro que /api/pro/alertes, en el formato OASIS CAP 1.2 (XML) que leen las herramientas de vigilancia y los automatismos de guardia. El sobre es un simple elemento <alertes>: cada <alert> que contiene es un documento CAP completo y separable. La gravedad se declara siempre Unknown, y es deliberado: GISFire mide una potencia radiativa y un número de píxeles, que nada dicen de lo que está en juego sobre el terreno. La medida figura en los <parameter>.

limite
Número máximo de alertas, de 1 a 500. 50 por defecto.

Un documento XML (application/xml) en UTF-8. Cada alerta lleva su área: el polígono de la zona, el de su margen de alerta y un círculo con la distancia de vigilancia. Los textos siguen el idioma de sus notificaciones.

curl -H "Authorization: Bearer gfp_..." \
  "https://gisfire.saro.app/api/pro/alertes/cap?limite=20"
GET/api/pro/alertes/{id}/cap

Una alerta sola en formato CAP 1.2.

El documento CAP de una sola entrada. El identificador desnudo (12) designa una detección de fuego; un aviso se escribe con su tipo (fumee-3, foudre-7), ya que los dos registros tienen sus propios contadores. Responde 404 si la alerta no existe o pertenece a otra cuenta.

Un documento XML (application/xml) con un único elemento <alert>.

curl -H "Authorization: Bearer gfp_..." \
  "https://gisfire.saro.app/api/pro/alertes/feu-21/cap"

Cargar el mapa en un programa SIG (OGC API Features)

Sin escribir una sola línea de código: GISFire también habla un formato de intercambio estándar para datos geográficos (OGC API Features), que los programas de cartografía como QGIS o ArcGIS saben leer directamente. Solo necesitan una dirección y su clave.

Tres conjuntos de datos: detecciones por satélite (los píxeles calientes de las últimas cuarenta y ocho horas), contornos de incendios (los incendios agrupados en un solo contorno) y sus zonas vigiladas. Los dos primeros son los mismos datos que el mapa público, presentados de una forma que su programa entiende de forma nativa.

GET/api/ogc

El punto de partida del flujo.

Este formato de intercambio estándar (OGC API Features) lo entienden directamente los programas de cartografía: ni una línea de código, basta una dirección. Esta página solo contiene enlaces al resto; un programa SIG la lee primero para saber adónde ir después.

Un documento JSON con enlaces a la declaración de conformidad y a la lista de colecciones.

curl -H "Authorization: Bearer gfp_..." \
  "https://gisfire.saro.app/api/ogc"
GET/api/ogc/conformance

Lo que este servicio realmente cumple.

La lista de reglas del estándar que este servicio aplica de verdad: la base común para datos geográficos, y el formato GeoJSON. Un programa SIG la consulta antes de confiar en el resto; un abonado normalmente no tiene nada que hacer con ella.

Un documento JSON con la lista de reglas cumplidas.

curl -H "Authorization: Bearer gfp_..." \
  "https://gisfire.saro.app/api/ogc/conformance"
GET/api/ogc/collections

Los tres conjuntos de datos disponibles.

La lista de colecciones ofrecidas: detecciones por satélite, contornos de incendios y sus zonas vigiladas. Esto es lo que un programa SIG muestra para elegir qué cargar en el mapa.

Un documento JSON con, para cada colección, su nombre, descripción y el enlace a sus datos.

curl -H "Authorization: Bearer gfp_..." \
  "https://gisfire.saro.app/api/ogc/collections"
GET/api/ogc/collections/{id}

La ficha de una colección.

El detalle de una colección concreta: «detections» (los píxeles calientes de las últimas cuarenta y ocho horas, todos los satélites juntos), «emprises» (los incendios agrupados en eventos) o «zones» (las suyas, la única de las tres ligada a su cuenta).

id
«detections», «emprises» o «zones», en la dirección.

Un documento JSON que describe la colección y el enlace a sus datos.

curl -H "Authorization: Bearer gfp_..." \
  "https://gisfire.saro.app/api/ogc/collections/zones"
GET/api/ogc/collections/{id}/items

Los datos en sí, listos para cargar.

Los elementos de la colección, en el formato GeoJSON estándar que cualquier programa de cartografía sabe leer. Una respuesta larga se divide en páginas: un enlace «next» lleva a la siguiente, hasta agotarlas.

bbox
Un rectángulo: longitud mínima, latitud mínima, longitud máxima, latitud máxima, separadas por comas.
datetime
Un instante, o un intervalo «inicio/fin» («..» para un extremo abierto), en formato ISO 8601.
limit
Elementos por página, 200 por defecto, 2000 como máximo.
offset
Elementos a saltar, para la página siguiente (ya incluido en el enlace «next»).

Una FeatureCollection GeoJSON, con numberMatched (el total), numberReturned (esta página) y un enlace «next» si quedan elementos.

curl -H "Authorization: Bearer gfp_..." \
  "https://gisfire.saro.app/api/ogc/collections/detections/items?bbox=-1.6,44.6,-0.5,45.2&limit=500"

Paso a paso en QGIS

  1. 1Menú Capa, luego Añadir capa, luego Añadir capa OGC API - Features.
  2. 2Nueva conexión: dele un nombre, y como URL use https://gisfire.saro.app/api/ogc
  3. 3En Configuraciones de autenticación, cree una de tipo Encabezado HTTP (o API Header, según la versión), con el encabezado Authorization y como valor Bearer seguido de su clave, por ejemplo Bearer gfp_....
  4. 4Guarde, seleccione la conexión y luego Conectar: las tres colecciones (detections, emprises, zones) aparecen en la lista.
  5. 5Marque la que le interese y pulse Añadir: la capa se carga en el mapa de QGIS, lista para estilizarse, filtrarse o combinarse con sus propios datos.

Webhook saliente

Una zona puede llevar una dirección de webhook: GISFire publica entonces un JSON en cuanto una detección de fuego cae dentro de la zona o de su margen. La dirección se configura desde el área de suscriptor. Solo las alertas de detección usan este canal; los avisos de humo y de rayo son personales y salen únicamente por correo y SMS.

El envío es un único POST, con Content-Type application/json, un plazo de cinco segundos y NINGÚN reintento: un fallo se ve en el registro de alertas (envois.webhook a false) y se recupera con GET /api/pro/alertes o su equivalente CAP, que devuelven la misma alerta. Cualquier respuesta fuera de 2xx cuenta como fallo, y las redirecciones no se siguen.

La dirección debe ser HTTPS y resolver hacia un host público: una dirección interna (127.0.0.1, 10.x, 169.254.169.254) se rechaza, redirecciones incluidas. Las marcas de tiempo son las de la base de detecciones, escritas con su desfase horario ("2026-09-14 11:34:00+02") y no en ISO 8601 estricto. position_approximative vale true cuando solo el satélite geoestacionario vio el fuego: la posición lleva entonces de tres a cuatro kilómetros de incertidumbre.

{
  "type": "alerte_feu",
  "zone": { "id": 8, "nom": "Massif de Saumos" },
  "periode": {
    "debut": "2026-09-14 11:34:00+02",
    "fin": "2026-09-14 11:34:00+02"
  },
  "detections": 6,
  "frpMaxMw": 25.77,
  "position_approximative": false,
  "carte": "https://gisfire.saro.app/#11/44.8700/-1.0500"
}

Lo que la API no hace (todavía)

No hay flujo en tiempo real (websocket o SSE): cada punto de entrada responde a una solicitud puntual. Para recibir aviso en cuanto ocurra una detección, use las alertas por correo, SMS o el webhook configurados en sus zonas, en lugar de consultar la API repetidamente.

La exportación está limitada a sus zonas vigiladas y a 50 000 filas por solicitud; por encima, reduzca la ventana o exporte zona por zona. No existe un punto de entrada para el dato mundial bruto, que sigue siendo cosa del mapa público y de NASA FIRMS.

Preguntas frecuentes

¿Se necesita un plan concreto para usar la API?
La API está incluida en el plan Pro y en el plan Organización; vea la comparativa de planes en la página de GISFire Pro.
¿Cuál es el límite de solicitudes?
No se publica en esta página por ahora; un uso razonable (unas pocas solicitudes por minuto) no supone un problema. Escríbanos si su integración tiene necesidades particulares.
¿Las respuestas tienen versión?
Todavía no mediante un número de versión en la URL. Un cambio que rompiera un campo existente se anunciaría a los suscriptores antes de desplegarse.

Ir más lejos

© 2026 SARO · Gistin. Todos los derechos reservados. La interfaz, su presentación y los contenidos de GISFire están protegidos; su reproducción o su imitación requiere autorización por escrito. Los datos de origen siguen siendo propiedad de sus respectivos productores, véanse los créditos.

Aviso legal · Política de privacidad · GISFire v2.1.0