开放 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通过一致性检查
自动检查会在上线前确认您的客户端行为正确。