Desarrolladores

Construya sobre Naavra, con seguridad

Una API versionada, webhooks firmados, conectores con los sistemas que ya usa y una forma de que sus propios agentes de IA trabajen con Naavra sin cruzar nunca un acto reservado a personas.

Solicitar acceso al entorno de pruebas Ver el modelo de seguridad

Listar sus buques

curl https://api.naavra.com/v1/vessels \
  -H "Authorization: Bearer $AUTOPILOT_TOKEN" \
  -H "Idempotency-Key: <uuid-generated-per-request>"

La API abierta

Todo lo que necesita para integrarse

API REST versionada

Una API publicada y versionada, con una política de obsolescencia clara. Cada llamada la ejecuta la parte de la plataforma responsable, con sus propias reglas.

Claves que usted controla

Cree los clientes usted mismo. Una clave se muestra una sola vez, se guarda solo como hash y puede rotarse o revocarse en cualquier momento.

Ámbitos de mínimo privilegio

Conceda solo lo que un cliente necesita. Los ámbitos que alcanzarían un acto reservado a personas no existen; no se pueden conceder.

Límites de uso e idempotencia

Envíe la misma clave de idempotencia y obtendrá la misma respuesta. Espere ante un 429; el uso es visible en su portal.

Webhooks firmados

Suscríbase a eventos del catálogo. Cada entrega va firmada con una marca de tiempo, se reintenta y puede repetirse.

Acceso para agentes de IA

Sus propios agentes pueden usar Naavra a través de un servidor de protocolo para agentes. Todo lo que tenga consecuencias espera a que una persona con nombre lo confirme.

Webhooks

Verifique cada entrega

Cada webhook lleva una marca de tiempo y una firma. Compruebe ambas, rechace lo caducado y sabrá que el contenido viene de Naavra.

Reintentos con espera creciente y después una cola de mensajes fallidos
Repita cualquier entrega desde su portal
Un registro de entregas para cada endpoint

Verificación de webhooks

// Verify an Naavra webhook (Node.js)
import crypto from "node:crypto";

export function verify(rawBody, header, secret) {
  const [t, sig] = header.split(",").map(p => p.split("=")[1]);
  if (Math.abs(Date.now() / 1000 - Number(t)) > 300) return false; // stale
  const mac = crypto.createHmac("sha256", secret)
                    .update(`${t}.${rawBody}`).digest("hex");
  return crypto.timingSafeEqual(Buffer.from(mac), Buffer.from(sig));
}

Conectores

Conecte los sistemas que ya usa

Contabilidad y ERP

Registre y reciba mediante correspondencias versionadas aprobadas por finanzas, incluidos paquetes de escritorio a través de un pequeño puente en su red.

Sistemas de viaje

Intercambie viajes, posiciones y resultados con los sistemas comerciales que usa su mesa.

Proveedores de desembolsos

Las cuentas proforma y finales llegan como propuestas, casadas con la escala y aceptadas por su mesa.

Portales de clase y bandera

Estado de inspecciones y certificados comparado con sus registros; una diferencia se eleva a una persona, nunca se sobrescribe.

Posiciones, meteorología y telemetría

Las posiciones AIS, la meteorología y los datos del motor alimentan las operaciones y el mantenimiento.

Informes y datos compartidos

Una capa de datos gobernada, paquetes de informes programados, fuentes para BI y datos compartidos en almacenes, cada cifra con su linaje.

El portal para desarrolladores

Empiece en el entorno de pruebas

1
Solicitar acceso
Abrimos un despliegue de pruebas con una flota sintética.
2
Crear un cliente
Elija los ámbitos; la clave se muestra una sola vez.
3
Suscribirse a eventos
Elija eventos del catálogo y añada su endpoint.
4
Superar la prueba de conformidad
Unas comprobaciones automáticas confirman que su cliente se comporta bien antes de ponerse en marcha.

Construya con nosotros

Díganos qué quiere conectar. Abriremos un entorno de pruebas con una flota sintética.

Solicitar acceso al entorno de pruebas Leer sobre la seguridad