Oilboards

WellSim · API del pozo virtual

— ← volver al panel

WellSim es un pozo "de verdad" en internet, con las tres salidas que tendría un pozo real. Todas salen del mismo motor físico: un estado maestro del que se derivan todas las señales, jerarquía de presiones garantizada por construcción y seis sistemas de levantamiento conmutables.

Esta API es la salida HTTP. Sirve para que el Conector de Campo lea el pozo como leería el suyo, para alimentar paneles en vivo y para controlar el pozo durante una demostración. Los controles son públicos a propósito: es un pozo de práctica compartido y todos los que lo miran ven lo mismo, como en campo.

Unidades: el pozo reporta en crudo (presiones en kg/cm², como un SCADA de campo mexicano). Cada lectura lleva su unit; la ingesta de Oilboards convierte a la unidad canónica y valida contra el catálogo.

HTTP / JSONGET /api/lecturas · el contrato que lee el Conector de Campo. Stream SSE en /api/stream.
RTU Modbus TCPwellsim.oilsuite.app:502 (pozo-demo-01) y :503 (pozo-demo-02). Holding registers, float32 big-endian, unit ID 1, solo lectura.
Conector → OilboardsEste servidor hace el POST /api/v1/ingest real con tu token de fuente. Token solo en memoria; destinos acotados al ecosistema.

Arranque rápido

Leer el pozo por HTTP

# lecturas del instante
curl -s https://wellsim.oilsuite.app/api/lecturas

# el segundo pozo (gas lift)
curl -s …/api/lecturas?pozo=pozo-demo-02

Leer el RTU Modbus (Python)

pip install pymodbus
# PT_CABEZA = registros 0-1, float32 BE
from pymodbus.client import ModbusTcpClient
c = ModbusTcpClient("wellsim.oilsuite.app", port=502)
r = c.read_holding_registers(0, 2, slave=1)
# mapa completo: GET /api/modbus/mapa

Conmutar y provocar una falla

curl -X POST …/api/levantamiento \
  -H 'Content-Type: application/json' \
  -d '{"tipo":"BEC"}'

curl -X POST …/api/escenario \
  -d '{"escenario":"gas-lock"}'