개발자
Naavra 위에 안전하게 구축
버전 관리 API, 서명된 웹훅, 이미 쓰는 시스템과의 커넥터, 그리고 사람만 하는 행위를 절대 넘지 않고 자사 AI 에이전트가 Naavra과 일하는 방법.
curl https://api.naavra.com/v1/vessels \
-H "Authorization: Bearer $AUTOPILOT_TOKEN" \
-H "Idempotency-Key: <uuid-generated-per-request>"오픈 API
연동에 필요한 모든 것
버전 관리 REST API
명확한 지원 종료 정책을 갖춘 공개 버전 관리 API. 모든 호출은 플랫폼의 담당 부분이 자체 규칙에 따라 수행합니다.
당신이 관리하는 키
클라이언트는 직접 만듭니다. 키는 한 번만 표시되고 해시로만 저장되며, 언제든 교체하거나 취소할 수 있습니다.
최소 권한 범위
클라이언트에 필요한 것만 부여하세요. 사람만 하는 행위에 닿는 범위는 존재하지 않으므로 부여할 수 없습니다.
요청 한도와 멱등성
같은 멱등 키를 보내면 같은 응답을 받습니다. 429에서는 백오프하세요. 사용량은 포털에서 볼 수 있습니다.
서명된 웹훅
이벤트 카탈로그에서 이벤트를 구독하세요. 모든 전송은 타임스탬프와 함께 서명되고, 재시도되며, 재생할 수 있습니다.
AI 에이전트 접근
자사 에이전트는 에이전트 프로토콜 서버를 통해 Naavra을 쓸 수 있습니다. 중대한 일은 이름 있는 사람의 확인을 기다립니다.
웹훅
모든 전송 확인
모든 웹훅에는 타임스탬프와 서명이 있습니다. 둘 다 확인하고 오래된 것을 거부하면 페이로드가 Naavra에서 왔음을 알 수 있습니다.
- 백오프 재시도, 그다음 데드레터 큐
- 포털에서 모든 전송 재생
- 모든 엔드포인트의 전송 로그
// 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));
}커넥터
이미 쓰는 시스템 연결
회계와 ERP
재무가 승인한 버전 관리 매핑으로 전기하고 수신하며, 네트워크 안의 작은 브리지를 통해 데스크톱 회계 프로그램도 지원.
항차 시스템
데스크가 쓰는 영업 시스템과 항차, 선위, 손익을 주고받습니다.
항비 서비스사
견적 정산서와 최종 정산은 제안으로 도착해 기항에 대사되고 데스크가 수락합니다.
선급·선적국 포털
검사 상태와 증서를 당신의 기록과 비교하고, 차이는 사람에게 올리며 절대 덮어쓰지 않습니다.
선위, 기상, 원격 측정
AIS 선위, 기상, 기관 데이터가 운항과 정비에 공급됩니다.
보고서와 데이터 공유
관리되는 데이터 계층, 예약 보고서 묶음, BI 피드, 데이터 웨어하우스 공유, 모든 숫자에 계보 포함.
개발자 포털
샌드박스에서 시작
- 1접근 요청
가상 선대가 담긴 샌드박스 배포를 열어 드립니다.
- 2클라이언트 만들기
범위를 고르세요. 키는 한 번만 표시됩니다.
- 3이벤트 구독
카탈로그에서 이벤트를 고르고 엔드포인트를 추가하세요.
- 4적합성 점검 통과
가동 전에 클라이언트가 올바르게 동작하는지 자동 점검으로 확인합니다.
함께 만들기
무엇을 연결하고 싶은지 알려주세요. 가상 선대가 담긴 샌드박스를 열어 드립니다.