Skip to content
Navo24Navo24

حزم 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-ts

استبدل 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 مباشرة.

الأدوات

أدوات إضافية تأتي مع كل مفتاح.

Webhooks

اختبر المستقبِل لديك

أنشئ webhook ثم اطلب منا إرسال ping. يسلك المسار نفسه الذي يسلكه الحدث الحقيقي: الترويسات نفسها والتوقيع نفسه وتسلسل إعادة المحاولة نفسه.

POST /webhooks/{id}/test
curl
curl -X POST https://api.navo24.com/v1/tracking/webhooks/{id}/test \
  -H "Authorization: Bearer $NAVO24_API_KEY"