Développeurs
Construire sur Naavra, en sécurité
Une API versionnée, des webhooks signés, des connecteurs vers les systèmes que vous utilisez déjà, et un moyen pour vos propres agents d’IA de travailler avec Naavra sans jamais franchir un acte réservé aux personnes.
curl https://api.naavra.com/v1/vessels \
-H "Authorization: Bearer $AUTOPILOT_TOKEN" \
-H "Idempotency-Key: <uuid-generated-per-request>"L’API ouverte
Tout ce qu’il faut pour intégrer
API REST versionnée
Une API publiée et versionnée, avec une politique de dépréciation claire. Chaque appel est exécuté par la partie de la plateforme qui en est responsable, selon ses propres règles.
Des clés que vous contrôlez
Créez vous-même vos clients. Une clé n’est affichée qu’une fois, stockée uniquement sous forme de hachage, et peut être renouvelée ou révoquée à tout moment.
Périmètres au moindre privilège
N’accordez que ce dont un client a besoin. Les périmètres qui atteindraient un acte réservé aux personnes n’existent pas ; ils ne peuvent pas être accordés.
Limites de débit et idempotence
Envoyez la même clé d’idempotence et obtenez la même réponse. Temporisez sur un 429 ; l’utilisation est visible dans votre portail.
Webhooks signés
Abonnez-vous aux événements du catalogue. Chaque livraison est signée avec un horodatage, relancée en cas d’échec, et peut être rejouée.
Accès pour les agents d’IA
Vos propres agents peuvent utiliser Naavra via un serveur de protocole pour agents. Tout ce qui a des conséquences attend la confirmation d’une personne nommée.
Webhooks
Vérifiez chaque livraison
Chaque webhook porte un horodatage et une signature. Vérifiez les deux, rejetez ce qui est périmé, et vous savez que le contenu vient d’Naavra.
- Nouvelles tentatives espacées, puis une file de lettres mortes
- Rejouez n’importe quelle livraison depuis votre portail
- Un journal de livraison pour chaque endpoint
// 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));
}Connecteurs
Connectez les systèmes que vous utilisez déjà
Comptabilité et ERP
Passez et recevez des écritures via des correspondances versionnées approuvées par la finance, y compris des logiciels de bureau via une petite passerelle sur votre réseau.
Systèmes de voyage
Échangez voyages, positions et résultats avec les systèmes commerciaux de votre bureau.
Prestataires de débours
Les comptes pro forma et finaux arrivent sous forme de propositions, rapprochés de l’escale et acceptés par votre bureau.
Portails de classe et de pavillon
Statut des visites et certificats comparés à vos enregistrements ; une différence remonte à une personne, jamais écrasée.
Positions, météo et télémesure
Les positions AIS, la météo et les données moteur alimentent les opérations et la maintenance.
Rapports et partage de données
Une couche de données gouvernée, des lots de rapports programmés, des flux BI et des partages d’entrepôt, chaque chiffre avec son lignage.
Le portail développeurs
Commencer dans le bac à sable
- 1Demander l’accès
Nous ouvrons un déploiement bac à sable avec une flotte synthétique.
- 2Créer un client
Choisissez les périmètres ; la clé n’est affichée qu’une fois.
- 3S’abonner aux événements
Choisissez des événements dans le catalogue et ajoutez votre endpoint.
- 4Réussir le contrôle de conformité
Des contrôles automatisés confirment que votre client se comporte correctement avant la mise en production.
Construire avec nous
Dites-nous ce que vous voulez connecter. Nous ouvrirons un bac à sable avec une flotte synthétique.