Documentación de API

Forecast API, Decision API y SDKs para integracion

Superficies de Producto

Research Workbench

Exploracion, comparacion de modelos, notebooks reproducibles

Ops Console

Estado de corridas, runtimes, costos, healthchecks

Forecast API

Acceso programatico a forecasts, ensembles, metadata

Decision API

Endpoints de negocio: frost risk, wind downtime, heat stress

Customer Portal

Dashboard para usuarios no cientificos

Endpoints

Forecast

POST /v1/forecast-runs         Trigger a forecast run
GET  /v1/forecasts/{run_id}    Get forecast results
GET  /v1/forecasts/{id}/fields?var=2t&lead=24h
GET  /v1/forecasts/{id}/timeseries?lat=-34.6&lon=-58.4

Ensembles & Blending

POST /v1/ensemble-runs         Trigger ensemble run
POST /v1/blends                Create blended forecast
POST /v1/downscaling-jobs      Submit downscaling job

Models & Registry

GET  /v1/models                List registered models
GET  /v1/models/{id}           Get model details
GET  /v1/benchmarks            List benchmark results

Decision Endpoints

POST /v1/decision/frost-risk           Frost risk assessment
POST /v1/decision/renewables-window    Renewable energy window
POST /v1/decision/heat-stress          Heat stress index

Data Catalog

GET  /v1/datasets              List datasets
GET  /v1/datasets/{id}         Get dataset details
GET  /v1/licenses              List license policies

Phase 1 Endpoints

Adapters & Inference

GET  /api/v1/adapters                    List registered adapters
GET  /api/v1/adapters/:id/healthcheck    Adapter healthcheck
POST /api/v1/adapters/:id/inference      Run inference pipeline
GET  /api/v1/adapters/healthcheck-all    Healthcheck all adapters

Orchestration

POST /api/v1/orchestrate/:runId          Run 8-step forecast pipeline
POST /api/v1/orchestrate/batch           Batch orchestration
GET  /api/v1/orchestrate/:runId/status   Pipeline status

Benchmark & Evaluation

POST /api/v1/benchmark/evaluate          Evaluate model
GET  /api/v1/benchmark/reports           Benchmark reports

Downscaling

POST /api/v1/downscale                   Submit downscaling job
POST /api/v1/bias-correction             Apply bias correction

Vertical Services

POST /api/v1/verticals/agri/assess       Agricultural assessment
POST /api/v1/verticals/energy/assess     Energy assessment
POST /api/v1/verticals/agri/frost-risk   Frost risk only
POST /api/v1/verticals/energy/generation Generation forecast

Observability

GET  /api/v1/observability/snapshot      Platform health snapshot
GET  /api/v1/observability/alerts        Active alerts

Provenance

Requisitos de Provenance

Toda API debe devolver provenance, uncertainty class, license class, benchmark tag y advertencia de uso apropiado.