API e integraciones de software acuícola
AquaOS se conecta con lo que usted ya usa. Los sensores y controladores envían datos, y una API documentada permite que sus otros sistemas los lean. Se ubica en medio de su instalación en lugar de encima de ella, y el acceso a la API está incluido en lugar de venderse como una mejora.
- RS-485 Modbus RTU, analógico, I2C, 1-Wire
- API REST con autenticación por token
- Webhooks salientes en alarmas
- Exportación XLSX y PDF en cada reporte
Cómo entran los datos a AquaOS
Tres caminos, y la mayoría de los despliegues usa más de uno.
Controladores de campo
El camino principal.
Un controlador lee sus sensores conectados en un intervalo y entrega mensajes firmados a la plataforma por red celular. Las lecturas llegan asociadas a la unidad de cultivo a la que está asignado el sensor. Cuando el enlace celular está caído, el controlador guarda en búfer local y entrega el pendiente al recuperarse, así el historial almacenado no queda con huecos.
Captura manual y móvil
Los eventos de producción, confirmaciones de alimentación, mortalidad, muestreos y lecturas de calidad del agua con equipo portátil se ingresan desde el espacio de trabajo web o la aplicación móvil.
Las lecturas manuales quedan en el mismo historial que los datos continuos de sensores.
Ingesta por API
Otros sistemas pueden enviar lecturas y eventos a AquaOS a través de la API.
Es la vía para un registrador de datos de otro proveedor, un sistema de control que ya tiene, o un sistema de laboratorio con mediciones que quiere en el mismo registro.
Soporte de sensores y dispositivos
AquaOS es agnóstico de sensores. El soporte es una propiedad de la capa de controladores, y un sensor se configura por unidad en la plataforma en lugar de requerir un cambio de firmware.
- RS-485 Modbus RTU
- El camino digital principal. La mayoría de las sondas industriales modernas de calidad del agua.
- Analógico
- Salidas de voltaje y lazo de corriente de sondas más antiguas o simples.
- I2C
- Sensores ambientales compactos y de placa.
- 1-Wire
- Sondas digitales de temperatura.
- Enlace celular
- Del controlador a la plataforma. Sin red local ni Wi-Fi en el estanque.
Leer el registro de producción de forma programática
Cada sistema conectado recibe su propia clave de acceso, separada del acceso de cualquier persona, de modo que puede desactivarse por su cuenta. Los datos están organizados como la plataforma: los sitios contienen unidades de cultivo, las unidades contienen el stock que hay en ellas, y cada lectura pertenece a una unidad.
Recursos
- Sitios y unidades de cultivo
- El modelo físico: sitios, unidades, tipos de unidad, área y volumen.
- Sensores y lecturas
- Dispositivos, su asociación a unidades y las series de tiempo que produjeron.
- Lotes y colocaciones
- Identidad del stock, dónde está, conteos, peso promedio y biomasa.
- Eventos
- Siembras, divisiones, traslados, clasificaciones, muestreos, mortalidad y cierres.
- Alarmas
- Cruces de umbral, su unidad y el estado de reconocimiento.
Acceso
curl https://api.aquaos.ai/v1/sites \
-H "Authorization: Bearer $AQUAOS_TOKEN" \
-H "Accept: application/json"Cada integración recibe su propia clave de acceso, y cada una puede desactivarse por separado. Solicítenos la documentación vigente de la API antes de empezar a desarrollar.
Hablar con el equipoCómo salen los datos de AquaOS
Lecturas REST
Extraiga sitios, unidades, sensores, lecturas, lotes y eventos hacia una herramienta de BI, un almacén de datos, un ERP o un sistema contable en su propio calendario.
Webhooks
Se disparan llamadas salientes en las alarmas para que un sistema externo reaccione sin hacer polling. Útil para enrutar hacia una herramienta de guardia o de incidentes existente.
Exportación de archivos
Cada reporte se exporta a XLSX y a PDF listo para imprimir. XLSX y no CSV, porque las hojas de cálculo recodifican el CSV al guardar y corrompen el texto no latino en el proceso.
Notificaciones
Entrega de alarmas al personal de turno, para que la respuesta operativa no dependa de que alguien tenga un panel abierto.
Preguntas frecuentes
¿El acceso a la API está incluido o es un complemento corporativo?
Es parte de la plataforma. Cada integración recibe su propia clave de acceso. No hay un plan corporativo aparte que desbloquee la API, porque una plataforma que guarda sus datos de producción y cobra extra por devolvérselos no es una plataforma abierta.
¿AquaOS puede recibir datos de un sistema que ya usamos?
Sí, a través de la API. Un registrador de datos de otro proveedor, un sistema de control que ya tenga, o un sistema de laboratorio pueden enviar lecturas y eventos para que vivan en el mismo registro de producción que todo lo demás.
¿Qué protocolos de sensores están soportados?
RS-485 Modbus RTU es el camino digital principal y cubre la mayoría de las sondas industriales modernas de calidad del agua. También hay soporte para salidas analógicas de voltaje y lazo de corriente, I2C y 1-Wire en la capa de controladores. Si una sonda específica funciona depende de su salida y su mapa de registros, y conviene preguntarlo con el número de modelo a la mano.
¿AquaOS soporta LoRaWAN?
La conectividad que se entrega y se soporta es la red celular, y es lo que hace práctico el despliegue en estanques remotos sin red local. Los controladores son modulares por diseño, así que otras opciones de radio son una pregunta de hardware que conviene plantear con la distribución del sitio y los números de modelo a la mano.
¿Cómo se autentican las integraciones?
Cada integración recibe su propia clave de acceso, separada del acceso de cualquier persona. Una clave puede desactivarse por su cuenta, así que quitar una integración nunca implica cambiar la contraseña de alguien ni desactivar su cuenta.
Vea AquaOS en su operación
Traiga un escenario real de producción. AquaOS se recorre sobre su operación, no sobre datos de muestra.