Entwickler

Sicher auf Naavra aufbauen

Eine versionierte API, signierte Webhooks, Konnektoren zu den Systemen, die Sie schon nutzen, und ein Weg für Ihre eigenen KI-Agenten, mit Naavra zu arbeiten, ohne je eine Handlung nur für Menschen zu überschreiten.

Sandbox-Zugang anfragen Das Sicherheitsmodell ansehen

Ihre Schiffe auflisten

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

Die offene API

Alles, was Sie für die Integration brauchen

Versionierte REST-API

Eine veröffentlichte, versionierte API mit klarer Deprecation-Richtlinie. Jeder Aufruf wird vom zuständigen Teil der Plattform nach dessen eigenen Regeln ausgeführt.

Schlüssel unter Ihrer Kontrolle

Legen Sie Clients selbst an. Ein Schlüssel wird einmal angezeigt, nur als Hash gespeichert und kann jederzeit rotiert oder widerrufen werden.

Scopes nach dem Minimalprinzip

Gewähren Sie nur, was ein Client braucht. Scopes, die eine Handlung nur für Menschen erreichen würden, existieren nicht; sie können nicht gewährt werden.

Ratenlimits und Idempotenz

Senden Sie denselben Idempotenzschlüssel und erhalten Sie dieselbe Antwort. Bei 429 zurückfahren; die Nutzung ist in Ihrem Portal sichtbar.

Signierte Webhooks

Abonnieren Sie Ereignisse aus dem Ereigniskatalog. Jede Zustellung ist mit Zeitstempel signiert, wird wiederholt und kann erneut gesendet werden.

Zugang für KI-Agenten

Ihre eigenen Agenten können Naavra über einen Server für ein Agentenprotokoll nutzen. Alles mit Tragweite wartet auf die Bestätigung einer benannten Person.

Webhooks

Jede Zustellung prüfen

Jeder Webhook trägt einen Zeitstempel und eine Signatur. Prüfen Sie beides, weisen Sie alles Veraltete zurück, und Sie wissen, dass die Nutzlast von Naavra kam.

Wiederholungen mit Back-off, dann eine Dead-Letter-Queue
Jede Zustellung aus Ihrem Portal erneut senden
Ein Zustellprotokoll für jeden Endpunkt

Webhook-Prüfung

// 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));
}

Konnektoren

Verbinden Sie die Systeme, die Sie schon nutzen

Buchhaltung und ERP

Buchen und empfangen über versionierte, von der Finanzabteilung freigegebene Mappings, auch für Desktop-Pakete über eine kleine Brücke in Ihrem Netzwerk.

Reisesysteme

Tauschen Sie Reisen, Positionen und Ergebnisse mit den kaufmännischen Systemen Ihres Desks aus.

Auslagendienstleister

Proforma- und Schlussabrechnungen kommen als Vorschläge, dem Hafenanlauf zugeordnet und von Ihrem Desk angenommen.

Klassen- und Flaggenportale

Besichtigungsstatus und Zertifikate mit Ihren Datensätzen verglichen; eine Abweichung geht an eine Person und wird nie überschrieben.

Positionen, Wetter und Telemetrie

AIS-Positionen, Wetter und Maschinendaten speisen Betrieb und Instandhaltung.

Berichte und Datenfreigabe

Eine gesteuerte Datenschicht, geplante Berichtspakete, BI-Feeds und Warehouse-Freigaben, jede Zahl mit ihrer Herkunft.

Das Entwicklerportal

In der Sandbox starten

1
Zugang anfragen
Wir öffnen ein Sandbox-Deployment mit einer synthetischen Flotte.
2
Einen Client anlegen
Wählen Sie Scopes; der Schlüssel wird einmal angezeigt.
3
Ereignisse abonnieren
Wählen Sie Ereignisse aus dem Katalog und fügen Sie Ihren Endpunkt hinzu.
4
Die Konformitätsprüfung bestehen
Automatische Prüfungen bestätigen, dass sich Ihr Client korrekt verhält, bevor er live geht.

Bauen Sie mit uns

Sagen Sie uns, was Sie verbinden möchten. Wir öffnen eine Sandbox mit einer synthetischen Flotte.

Sandbox-Zugang anfragen Über Sicherheit lesen