Mga developer
Bumuo sa Naavra, nang ligtas
Isang versioned API, signed webhook, mga connector sa mga sistemang ginagamit mo na, at paraan para magtrabaho ang sarili mong mga AI agent kasama ang Naavra nang hindi kailanman lumalampas sa aksyong pantao lang.
curl https://api.naavra.com/v1/vessels \
-H "Authorization: Bearer $AUTOPILOT_TOKEN" \
-H "Idempotency-Key: <uuid-generated-per-request>"Ang bukas na API
Lahat ng kailangan mo para mag-integrate
Versioned REST API
Isang nakalathala at versioned na API na may malinaw na deprecation policy. Bawat call ay isinasagawa ng bahagi ng platform na may-ari nito, ayon sa sarili nitong patakaran.
Mga key na ikaw ang may kontrol
Ikaw mismo ang gumawa ng client. Isang beses lang ipinapakita ang key, hash lang ang itinatago, at puwedeng i-rotate o bawiin anumang oras.
Least-privilege na scope
Ibigay lang ang kailangan ng client. Wala ang mga scope na aabot sa aksyong pantao lang; hindi ito maibibigay.
Rate limit at idempotency
Ipadala ang parehong idempotency key at makuha ang parehong sagot. Mag-back off sa 429; makikita ang paggamit sa portal mo.
Signed webhook
Mag-subscribe sa mga event mula sa event catalogue. Signed na may timestamp ang bawat delivery, inuulit, at puwedeng i-replay.
Access para sa AI agent
Magagamit ng sarili mong mga agent ang Naavra sa pamamagitan ng agent protocol server. Anumang may bigat ay naghihintay ng kumpirmasyon ng isang taong may pangalan.
Mga webhook
Beripikahin ang bawat delivery
May timestamp at signature ang bawat webhook. Suriin ang dalawa, tanggihan ang anumang luma, at malalaman mong galing sa Naavra ang payload.
- Retry na may back-off, tapos dead-letter queue
- I-replay ang anumang delivery mula sa portal mo
- Delivery log para sa bawat 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));
}Mga connector
Ikonekta ang mga sistemang pinapatakbo mo na
Accounting at ERP
Mag-post at tumanggap gamit ang versioned mapping na inaprubahan ng finance, kasama ang desktop package sa pamamagitan ng maliit na bridge sa network mo.
Mga voyage system
Makipagpalitan ng biyahe, posisyon, at resulta sa mga commercial system na gamit ng desk mo.
Mga disbursement provider
Dumarating ang pro-forma at final account bilang mungkahi, tinugma sa port call, tinanggap ng desk mo.
Mga portal ng class at flag
Inihahambing ang survey status at sertipiko sa record mo; iniaakyat sa tao ang anumang pagkakaiba, hindi kailanman ino-overwrite.
Posisyon, panahon, at telemetry
Pinapakain ng AIS position, panahon, at engine data ang operasyon at maintenance.
Report at pagbabahagi ng data
Isang pinamamahalaang data layer, naka-iskedyul na report pack, BI feed, at warehouse share, bawat numero kasama ang pinagmulan nito.
Ang developer portal
Magsimula sa sandbox
- 1Humiling ng access
Nagbubukas kami ng sandbox deployment na may synthetic na fleet.
- 2Gumawa ng client
Pumili ng scope; isang beses lang ipinapakita ang key.
- 3Mag-subscribe sa mga event
Pumili ng event mula sa katalogo at idagdag ang endpoint mo.
- 4Pumasa sa conformance check
Kinukumpirma ng automated na check na maayos ang asal ng client mo bago mag-live.
Bumuo kasama namin
Sabihin sa amin kung ano ang gusto mong ikonekta. Magbubukas kami ng sandbox na may synthetic na fleet.