Pengembang
Bangun di atas Naavra, dengan aman
API berversi, webhook bertanda tangan, konektor ke sistem yang sudah Anda pakai, dan cara bagi agen AI Anda sendiri untuk bekerja dengan Naavra tanpa pernah melewati tindakan khusus manusia.
curl https://api.naavra.com/v1/vessels \
-H "Authorization: Bearer $AUTOPILOT_TOKEN" \
-H "Idempotency-Key: <uuid-generated-per-request>"API terbuka
Semua yang Anda perlukan untuk integrasi
REST API berversi
API yang dipublikasikan dan berversi, dengan kebijakan penghentian yang jelas. Setiap panggilan dijalankan oleh bagian platform yang berwenang, sesuai aturannya sendiri.
Kunci yang Anda kendalikan
Buat klien sendiri. Kunci ditampilkan sekali, disimpan hanya sebagai hash, dan bisa dirotasi atau dicabut kapan saja.
Scope hak akses minimum
Berikan hanya yang dibutuhkan klien. Scope yang bisa menjangkau tindakan khusus manusia tidak ada; tidak bisa diberikan.
Batas laju dan idempotensi
Kirim kunci idempotensi yang sama dan dapatkan jawaban yang sama. Mundur saat 429; pemakaian terlihat di portal Anda.
Webhook bertanda tangan
Berlangganan event dari katalog event. Setiap pengiriman ditandatangani dengan stempel waktu, dicoba ulang, dan bisa diputar ulang.
Akses untuk agen AI
Agen Anda sendiri bisa memakai Naavra lewat server protokol agen. Apa pun yang berdampak menunggu konfirmasi dari orang yang bernama.
Webhook
Verifikasi setiap pengiriman
Setiap webhook membawa stempel waktu dan tanda tangan. Periksa keduanya, tolak yang basi, dan Anda tahu muatannya berasal dari Naavra.
- Coba ulang dengan back-off, lalu antrean dead-letter
- Putar ulang pengiriman apa pun dari portal Anda
- Log pengiriman untuk setiap 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));
}Konektor
Hubungkan sistem yang sudah Anda jalankan
Akuntansi dan ERP
Posting dan terima lewat pemetaan berversi yang disetujui keuangan, termasuk paket desktop lewat bridge kecil di jaringan Anda.
Sistem pelayaran
Bertukar pelayaran, posisi, dan hasil dengan sistem komersial yang dipakai meja Anda.
Penyedia disbursement
Akun pro-forma dan final datang sebagai usulan, dicocokkan dengan singgah pelabuhan, diterima oleh meja Anda.
Portal klasifikasi dan bendera
Status survei dan sertifikat dibandingkan dengan catatan Anda; selisih diteruskan ke manusia, tidak pernah ditimpa.
Posisi, cuaca, dan telemetri
Posisi AIS, cuaca, dan data mesin memasok operasi dan perawatan.
Laporan dan berbagi data
Lapisan data yang terkelola, paket laporan terjadwal, feed BI, dan berbagi data warehouse, setiap angka dengan asal-usulnya.
Portal pengembang
Mulai di sandbox
- 1Minta akses
Kami membuka deployment sandbox dengan armada sintetis.
- 2Buat klien
Pilih scope; kunci ditampilkan sekali.
- 3Berlangganan event
Pilih event dari katalog dan tambahkan endpoint Anda.
- 4Lulus pemeriksaan kesesuaian
Pemeriksaan otomatis memastikan klien Anda berperilaku baik sebelum ditayangkan.
Bangun bersama kami
Beri tahu kami apa yang ingin Anda hubungkan. Kami akan membuka sandbox dengan armada sintetis.