Desenvolvedores

Construa sobre o Naavra, com segurança

Uma API versionada, webhooks assinados, conectores com os sistemas que você já usa e um jeito de os seus próprios agentes de IA trabalharem com o Naavra sem nunca cruzar um ato exclusivo de pessoas.

Solicitar acesso ao ambiente de testes Ver o modelo de segurança

Listar os seus navios

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

A API aberta

Tudo de que você precisa para integrar

API REST versionada

Uma API publicada e versionada, com uma política clara de descontinuação. Cada chamada é executada pela parte responsável da plataforma, sob as próprias regras.

Chaves que você controla

Crie os clientes você mesmo. A chave aparece uma única vez, é guardada só como hash e pode ser trocada ou revogada a qualquer momento.

Escopos de privilégio mínimo

Conceda só o que um cliente precisa. Escopos que alcançariam um ato exclusivo de pessoas não existem; não podem ser concedidos.

Limites de uso e idempotência

Envie a mesma chave de idempotência e receba a mesma resposta. Espere diante de um 429; o uso fica visível no seu portal.

Webhooks assinados

Assine eventos do catálogo. Cada entrega é assinada com carimbo de tempo, tem novas tentativas e pode ser reenviada.

Acesso para agentes de IA

Seus próprios agentes podem usar o Naavra por meio de um servidor de protocolo para agentes. Tudo o que tiver consequência espera a confirmação de uma pessoa nomeada.

Webhooks

Verifique cada entrega

Cada webhook traz um carimbo de tempo e uma assinatura. Confira os dois, rejeite o que estiver velho e você saberá que o conteúdo veio do Naavra.

Novas tentativas com espera crescente, depois uma fila de mensagens mortas
Reenvie qualquer entrega a partir do seu portal
Um log de entregas para cada endpoint

Verificação 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 os sistemas que você já usa

Contabilidade e ERP

Lance e receba por mapeamentos versionados aprovados pelo financeiro, incluindo pacotes de desktop por meio de uma pequena ponte na sua rede.

Sistemas de viagem

Troque viagens, posições e resultados com os sistemas comerciais que a sua mesa usa.

Provedores de desembolsos

Contas proforma e finais chegam como propostas, conciliadas com a escala e aceitas pela sua mesa.

Portais de classe e bandeira

Situação de vistorias e certificados comparada com os seus registros; uma diferença é levada a uma pessoa, nunca sobrescrita.

Posições, meteorologia e telemetria

Posições AIS, meteorologia e dados do motor alimentam as operações e a manutenção.

Relatórios e compartilhamento de dados

Uma camada de dados governada, pacotes de relatórios agendados, feeds de BI e compartilhamentos de data warehouse, cada número com a sua linhagem.

O portal do desenvolvedor

Comece no ambiente de testes

1
Solicitar acesso
Abrimos uma implantação de testes com uma frota sintética.
2
Criar um cliente
Escolha os escopos; a chave aparece uma única vez.
3
Assinar eventos
Escolha eventos do catálogo e adicione o seu endpoint.
4
Passar na verificação de conformidade
Verificações automáticas confirmam que o seu cliente se comporta bem antes de entrar em produção.

Construa conosco

Diga o que quer conectar. Abriremos um ambiente de testes com uma frota sintética.

Solicitar acesso ao ambiente de testes Ler sobre segurança