ORBITAL GRID API

curl -s -X POST {{BASE}}/v1/intent \
  -H "Content-Type: application/json" \
  -H "X-API-Key: TU_API_KEY" \
  -d '{"query":"serie NDVI y NDMI de mi AOI en Pergamino en el último mes"}'

import httpx

r = httpx.post(
    "{{BASE}}/v1/intent",
    headers={"X-API-Key": "TU_API_KEY"},
    json={"query": "serie NDVI y NDMI de mi AOI en Pergamino en el último mes"},
    timeout=60,
)
data = r.json()
print(data["selected_satellite"], "→", data["explanation"])

const r = await fetch("{{BASE}}/v1/intent", {
  method: "POST",
  headers: { "Content-Type": "application/json", "X-API-Key": "TU_API_KEY" },
  body: JSON.stringify({ query: "serie NDVI y NDMI de mi AOI en Pergamino en el último mes" }),
});
const data = await r.json();
console.log(data.selected_satellite, data.explanation);

curl -s {{BASE}}/health

import httpx
print(httpx.get("{{BASE}}/health", timeout=30).json())

const h = await (await fetch("{{BASE}}/health")).json();
console.log(h.status, h.catalogs);

curl -s "{{BASE}}/v1/satellites?data_type=sar&access=live"

import httpx
sats = httpx.get("{{BASE}}/v1/satellites",
                 params={"data_type": "sar", "access": "live"}, timeout=30).json()
print(sats["count"], "satélites SAR live")

const s = await (await fetch("{{BASE}}/v1/satellites?data_type=sar&access=live")).json();
console.log(s.count, "satélites SAR live");

curl -s -X POST {{BASE}}/v1/imagery/search \
  -H "Content-Type: application/json" -H "X-API-Key: TU_API_KEY" \
  -d '{"bbox":[-60.70,-34.00,-60.50,-33.80],
       "datetime_from":"2026-04-01","datetime_to":"2026-07-06",
       "data_type":"optical","max_resolution_m":30,
       "cloud_cover_max":20,"priority":"resolution","limit":3}'

import httpx

r = httpx.post("{{BASE}}/v1/imagery/search",
    headers={"X-API-Key": "TU_API_KEY"},
    json={"bbox": [-60.70, -34.00, -60.50, -33.80],
          "datetime_from": "2026-04-01", "datetime_to": "2026-07-06",
          "data_type": "optical", "max_resolution_m": 30,
          "cloud_cover_max": 20, "priority": "resolution", "limit": 3},
    timeout=120)
res = r.json()
print(res["selected_satellite"], res["selected_reason"])
for sc in res["scenes"]:
    print(" ", sc["satellite"], sc["datetime"], sc.get("cloud_cover"))

const r = await fetch("{{BASE}}/v1/imagery/search", {
  method: "POST",
  headers: { "Content-Type": "application/json", "X-API-Key": "TU_API_KEY" },
  body: JSON.stringify({
    bbox: [-60.70, -34.00, -60.50, -33.80],
    datetime_from: "2026-04-01", datetime_to: "2026-07-06",
    data_type: "optical", max_resolution_m: 30,
    cloud_cover_max: 20, priority: "resolution", limit: 3,
  }),
});
const res = await r.json();
console.log(res.selected_satellite, res.switched, res.switch_trace);

curl -s -X POST {{BASE}}/v1/intent \
  -H "Content-Type: application/json" -H "X-API-Key: TU_API_KEY" \
  -d '{"query":"buscar escenas comparables y señales candidatas de agua nueva en Pehuajó"}'

import httpx
r = httpx.post("{{BASE}}/v1/intent", headers={"X-API-Key": "TU_API_KEY"},
               json={"query": "buscar escenas comparables y señales candidatas de agua nueva en Pehuajó"},
               timeout=120)
d = r.json()
print(d["interpretation"], d["selected_satellite"], d["explanation"], sep="\n")

const d = await (await fetch("{{BASE}}/v1/intent", {
  method: "POST",
  headers: { "Content-Type": "application/json", "X-API-Key": "TU_API_KEY" },
  body: JSON.stringify({ query: "buscar escenas comparables y señales candidatas de agua nueva en Pehuajó" }),
})).json();
console.log(d.inferred_params, d.selected_satellite);

curl -s -X POST {{BASE}}/v1/agent/ask \
  -H "Content-Type: application/json" -H "X-API-Key: TU_API_KEY" \
  -d '{"question":"¿cómo está mi campo esta semana?","lat":-33.90,"lon":-60.60}'

import httpx
# Zona por bbox (alternativa al punto): p. ej. la envolvente de un AOI subido.
r = httpx.post("{{BASE}}/v1/agent/ask",
               headers={"X-API-Key": "TU_API_KEY"},
               json={"question": "¿qué escenas y señales de agua requieren revisión?",
                     "bbox": [-60.70, -34.00, -60.50, -33.80]},
               timeout=120)
d = r.json()
print(d["status"], d["semaphore"], d["answer"])

const d = await (await fetch("{{BASE}}/v1/agent/ask", {
  method: "POST",
  headers: { "Content-Type": "application/json", "X-API-Key": "TU_API_KEY" },
  body: JSON.stringify({ question: "¿cómo está mi campo?", lat: -33.90, lon: -60.60 }),
})).json();
console.log(d.status, d.semaphore, d.provenance);

curl -s -X POST {{BASE}}/v1/analytics/fields \
  -H "Content-Type: application/json" -H "X-API-Key: TU_API_KEY" \
  -d '{"bbox":[-60.65,-33.90,-60.60,-33.85],"min_confidence":0.8}'

import httpx
r = httpx.post("{{BASE}}/v1/analytics/fields",
               headers={"X-API-Key": "TU_API_KEY"},
               json={"bbox": [-60.65, -33.90, -60.60, -33.85], "min_confidence": 0.8},
               timeout=60)
d = r.json()
if d["status"] == "delivered":
    print(d["summary"])          # salida experimental; requiere revisión humana
    geojson = d["result"]        # celdas de demo, no límites de parcelas
else:
    print(d["message"])          # AOI aún no procesada — respuesta honesta

const d = await (await fetch("{{BASE}}/v1/analytics/fields", {
  method: "POST",
  headers: { "Content-Type": "application/json", "X-API-Key": "TU_API_KEY" },
  body: JSON.stringify({ bbox: [-60.65, -33.90, -60.60, -33.85], min_confidence: 0.8 }),
})).json();
console.log(d.status, d.summary ?? d.message);

curl -s -X POST {{BASE}}/v1/aoi/parse \
  -H "X-API-Key: TU_API_KEY" \
  -F "file=@mi_campo.kml"

import httpx
with open("mi_campo.geojson", "rb") as f:
    r = httpx.post("{{BASE}}/v1/aoi/parse",
                   headers={"X-API-Key": "TU_API_KEY"},
                   files={"file": ("mi_campo.geojson", f, "application/geo+json")},
                   timeout=60)
aoi = r.json()
if aoi["ok"]:
    print(aoi["area_km2"], "km²", aoi["vertex_count"], "vértices")
    bbox = aoi["bbox"]          # [oeste, sur, este, norte]
else:
    print("No se pudo:", aoi["error"])

// Cuerpo JSON con WKT (alternativa a subir un archivo)
const aoi = await (await fetch("{{BASE}}/v1/aoi/parse", {
  method: "POST",
  headers: { "Content-Type": "application/json", "X-API-Key": "TU_API_KEY" },
  body: JSON.stringify({ wkt: "POLYGON((-60.7 -34.0,-60.5 -34.0,-60.5 -33.8,-60.7 -33.8,-60.7 -34.0))" }),
})).json();
console.log(aoi.ok, aoi.area_km2, aoi.bbox);

curl -s -X POST "{{BASE}}/v1/exports/footprints?format=geojson" \
  -H "Content-Type: application/json" -H "X-API-Key: TU_API_KEY" \
  -d '{"search":{"bbox":[-60.70,-34.00,-60.50,-33.80],
       "datetime_from":"2026-04-01","datetime_to":"2026-07-06",
       "data_type":"optical","limit":10}}' \
  -o footprints.geojson

import httpx
# scenes = res["scenes"]  # p. ej. la respuesta de /v1/imagery/search
r = httpx.post("{{BASE}}/v1/exports/footprints",
               params={"format": "shapefile"},
               headers={"X-API-Key": "TU_API_KEY"},
               json={"scenes": scenes},
               timeout=120)
if r.headers.get("X-Export-Fallback") == "geojson":
    print("Shapefile no disponible; llegó GeoJSON:", r.headers.get("X-Export-Note"))
open("footprints.zip", "wb").write(r.content)

const r = await fetch("{{BASE}}/v1/exports/footprints?format=geojson", {
  method: "POST",
  headers: { "Content-Type": "application/json", "X-API-Key": "TU_API_KEY" },
  body: JSON.stringify({ scenes }),   // o { search: { bbox, datetime_from, ... } }
});
const fc = await r.json();            // FeatureCollection (application/geo+json)
console.log(fc.features.length, "footprints");

curl -s {{BASE}}/v1/account/usage -H "X-API-Key: TU_API_KEY"

import httpx
u = httpx.get("{{BASE}}/v1/account/usage",
              headers={"X-API-Key": "TU_API_KEY"}, timeout=30).json()
print(u["usage"]["total"], "requests")

const u = await (await fetch("{{BASE}}/v1/account/usage",
  { headers: { "X-API-Key": "TU_API_KEY" } })).json();
console.log(u.usage.total, "requests");