حزم SDK والأدوات
كل ما تحتاجه للبناء على Navo24.
مواصفات OpenAPI لكل منتج، وعميل مُحدَّد الأنواع بلغتك بأمر واحد، ومجموعات Postman جاهزة، وخوادم MCP لمساعدي الذكاء الاصطناعي، وزر اختبار لمستقبِل الـ webhook لديك.
اختر كيف يتواصل نظامك مع Navo24.
REST API
استدعِ الـ API من شيفرتك الخاصة
يرسل نظامك الخلفي رقم حاوية أو بوليصة شحن جوي أو مسارًا إلى https://api.navo24.com/v1/<product> مع مفتاح bearer ويتلقى JSON. استخدم عميلًا مُنشأً أو مجموعة Postman أو طلبات HTTP مباشرة.
اقرأ دليل البدء السريعMCP
دع مساعد الذكاء الاصطناعي يستدعي الأدوات
يتصل Claude أو Cursor أو ChatGPT أو أي عميل MCP بخادم Navo24 MCP ويستدعي التتبع وجداول الإبحار والأسعار وتخطيط التحميل كأدوات. دون كتابة أي شيفرة للعميل.
البدء السريع مع MCPمكتبات العملاء
عميل مُحدَّد الأنواع بلغتك، بأمر واحد.
ينشر كل منتج مواصفة OpenAPI 3 تشير مسبقًا إلى api.navo24.com. شغّل OpenAPI Generator عليها لتحصل على النماذج وفئة API لكل قسم ومعالجة المصادقة. نُنشئ الأهداف الستة أدناه جميعها من مواصفاتنا قبل كل إصدار.
لم تُنشر بعد حزم Navo24 الرسمية على npm وPyPI والسجلات الأخرى. وإلى أن تُنشر، أنشئ العميل بنفسك: سيبقى متوافقًا مع الـ API في كل مرة تعيد إنشاءه.
شرح تفصيلي مع غلاف fetch مكتوب يدويًاnpx @openapitools/openapi-generator-cli generate \
-i https://navo24.com/developers/openapi/tracking.json \
-g typescript-fetch \
-o ./navo24-tracking-tsnpx @openapitools/openapi-generator-cli generate \
-i https://navo24.com/developers/openapi/tracking.json \
-g python \
-o ./navo24-tracking-pynpx @openapitools/openapi-generator-cli generate \
-i https://navo24.com/developers/openapi/tracking.json \
-g php \
-o ./navo24-tracking-phpnpx @openapitools/openapi-generator-cli generate \
-i https://navo24.com/developers/openapi/tracking.json \
-g java \
-o ./navo24-tracking-javanpx @openapitools/openapi-generator-cli generate \
-i https://navo24.com/developers/openapi/tracking.json \
-g csharp \
-o ./navo24-tracking-dotnetnpx @openapitools/openapi-generator-cli generate \
-i https://navo24.com/developers/openapi/tracking.json \
-g go \
-o ./navo24-tracking-goاستبدل tracking.json بـ air.json أو schedules.json أو loading.json أو rates.json للحصول على المنتجات الأخرى. يتطلب Node.js 18+ وJava 11+؛ وتقبل صورة Docker المسماة openapitools/openapi-generator-cli الخيارات نفسها.
OpenAPI وPostman
مواصفات ومجموعات لكل منتج.
نزّل المواصفة لتوليد الشيفرة أو اختبارات العقود، أو استورد المجموعة وأرسل طلبك الأول خلال دقيقة. اضبط المتغير apiKey على مفتاحك؛ أما baseUrl فمعبأ مسبقًا.
يستورد Bruno وInsomnia المجموعة نفسها أو ملف OpenAPI مباشرة.
الأدوات
أدوات إضافية تأتي مع كل مفتاح.
أمثلة الشيفرة
لكل نقطة نهاية في المرجع طلبات جاهزة للنسخ واللصق بـ curl وJavaScript وPython، مع استجابات حقيقية.
تصفح المرجعخوادم MCP
خادم MCP لكل منتج، بالإضافة إلى mcp.navo24.com للمسافات وCO2e والسفن والرحلات الجوية. المفتاح نفسه المستخدم مع الـ API.
خادم Navo24 MCPإرسال اختباري للـ webhook
أرسل حدثًا اختباريًا موقّعًا إلى المستقبِل لديك من أي منتج، وتحقق من الترويسات والغلاف وإعادة المحاولات من البداية إلى النهاية.
دليل الـ webhooksتطبيقات قابلة للتضمين
التتبع والأسعار وجداول الإبحار على موقع العميل بعلامته التجارية، بوسم script واحد ومفتاح مقيّد بالنطاق.
ضمّن التطبيقاتموجز أحداث DCSA
أحداث Track & Trace بصيغة DCSA، للأنظمة التي تعتمد هذا المعيار بالفعل.
موجز DCSAالأخطاء وحدود المعدل
غلاف أخطاء موحّد عبر المنتجات، ورموز الحالة التي يُبنى عليها التفرع، وكيفية التراجع التدريجي عند إعادة المحاولة.
الأخطاء والحدودWebhooks
اختبر المستقبِل لديك
أنشئ webhook ثم اطلب منا إرسال ping. يسلك المسار نفسه الذي يسلكه الحدث الحقيقي: الترويسات نفسها والتوقيع نفسه وتسلسل إعادة المحاولة نفسه.
POST /webhooks/{id}/testcurl -X POST https://api.navo24.com/v1/tracking/webhooks/{id}/test \
-H "Authorization: Bearer $NAVO24_API_KEY"