開発者
Naavra の上で安全に構築
バージョン管理された API、署名つき Webhook、既存システムへのコネクタ、そして人だけが行う行為を決して越えずに自社の 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 ではバックオフしてください。利用状況はポータルで確認できます。
署名つき Webhook
イベントカタログからイベントを購読。各配信はタイムスタンプつきで署名され、再試行され、再送できます。
AI エージェント向けアクセス
自社のエージェントはエージェントプロトコルサーバー経由で Naavra を使えます。影響の大きい操作は、名前のある人の確認を待ちます。
Webhook
すべての配信を検証
各 Webhook にはタイムスタンプと署名が付きます。両方を検証し、古いものを拒否すれば、ペイロードが 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適合性チェックに合格
本番稼働前に、クライアントが正しく動作することを自動チェックで確認します。
一緒に作る
接続したいものを教えてください。模擬船隊入りのサンドボックスを用意します。