المطوّرون
ابنِ على Naavra بأمان
واجهة API بإصدارات، وخطافات ويب موقّعة، وموصلات بالأنظمة التي تستخدمها بالفعل، وطريقة لوكلاء الذكاء الاصطناعي الخاصين بك للعمل مع 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؛ والاستخدام ظاهر في بوابتك.
خطافات ويب موقّعة
اشترك في الأحداث من كتالوج الأحداث. كل تسليم موقّع بطابع زمني، ويُعاد المحاولة، ويمكن إعادة تشغيله.
وصول وكلاء الذكاء الاصطناعي
يمكن لوكلائك استخدام 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اجتز فحص المطابقة
فحوص آلية تؤكد سلامة سلوك العميل قبل تشغيله.
ابنِ معنا
أخبرنا بما تريد ربطه. سنفتح بيئة اختبار بأسطول افتراضي.