Skip to content
Navo24Navo24
ابدأ مجانًا

البدء

البدء

البدء السريع مع API تتبع الحاويات: أول طلب إلى Navo24 خلال دقيقتين دون مفتاح، ثم مفتاح API وشحنة قيد التتبع.

Navo24 هو ذكاء شحن تستدعيه مباشرة: تتبع الحاويات وبوالص الشحن الجوي، وجداول الإبحار وموثوقيتها، وأسعار الشحن الفورية وتخطيط التحميل. يأتي كل منتج مع REST API، ومعظمها يأتي أيضًا مع خادم MCP، وكلها تعمل بمفتاح bearer واحد.

أرسل طلبًا دون حساب

أسرع طريقة لرؤية بيانات حقيقية هي نقطة النهاية العامة في API تتبع الحاويات. لا تحتاج إلى مفتاح.

curl -X POST https://api.trackingmcp.com/v1/track/public \
  -H "Content-Type: application/json" \
  -d '{"reference":"MEDU1234562"}'

ستحصل على حالة موحدة، والسفينة، والمراحل الرئيسية، وموعد وصول متوقع (ETA) يوضح ما إذا كان لا يزال تقديرًا:

{
  "ok": true,
  "data": {
    "identifier": "MEDU1234562",
    "identifier_type": "container_id",
    "carrier_code": "MSCU",
    "carrier_name": "MSC",
    "status": "in_transit",
    "eta": "2026-07-03T06:00:00Z",
    "eta_is_estimated": true,
    "origin": "Ningbo",
    "destination": "Rotterdam",
    "vessel": { "name": "MSC TERESA", "lat": null, "lng": null },
    "events": [
      {
        "description": "Loaded on vessel",
        "location": "Ningbo",
        "event_code": "LOAD",
        "unlocode": "CNNGB",
        "datetime": "2026-06-18T22:10:00Z",
        "actual": true
      }
    ]
  }
}

تحمل أربعة حقول معظم المعنى:

  • identifier_type هو ما قررنا أن المرجع عليه فعلًا، وقد يختلف عن تخمينك.
  • eta_is_estimated تكون true ما دام ETA تقديرًا، وfalse بمجرد أن يصبح الوصول الفعلي، وnull عندما لا يتوفر لدينا أي ETA. التاريخ وحده ليس وعدًا.
  • actual في الحدث تكون true لما حدث فعلًا وfalse لما هو مخطط له. لا تعامل أي حركة مخطط لها على أنها حقيقة.
  • carrier_code وorigin وdestination وunlocode تكون null عندما لا يذكر الناقل شيئًا يمكننا تحديده، بدلًا من التخمين.

نقاط النهاية العامة محدودة المعدل لكل عنوان IP ومخصصة للتحقق السريع. أي عمل على مستوى محفظة شحنات يحتاج إلى مفتاح.

احصل على مفتاح API

  1. سجّل في trackingmcp.com.
  2. افتح إعدادات المطور وأنشئ مفتاحًا. يحمل المفتاح بادئة المنتج، مثل tmcp_ للتتبع.
  3. أرسله كرمز bearer مع كل طلب يتطلب مصادقة.
curl https://api.trackingmcp.com/v1/containers/summary \
  -H "Authorization: Bearer tmcp_YOUR_API_KEY"
{
  "ok": true,
  "data": {
    "total_active": 128,
    "exceptions": 6,
    "arriving_this_week": 14,
    "demurrage_risk_usd": 4820.5,
    "containers": []
  }
}

ابدأ تتبع شحنة

تتطلب الواجهة المحمية بمفتاح حقلين إلزاميين: identifier وidentifier_type. ويكون النوع أحد القيم container_id أو bill_of_lading أو booking.

curl -X POST https://api.trackingmcp.com/v1/containers \
  -H "Authorization: Bearer tmcp_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"identifier":"MEDU1234562","identifier_type":"container_id"}'
{
  "ok": true,
  "data": {
    "id": "8f1c2d4e-6a3b-4f52-9c70-11ab22cd33ef",
    "identifier": "MEDU1234562",
    "status": "in_transit",
    "carrier_code": "MSCU",
    "source": "direct_carrier"
  }
}

احتفظ بقيمة id. إنها UUID، وجميع نقاط نهاية الحاويات الأخرى تعتمد عليها لا على رقم الحاوية. الحاوية التي نقبلها لكن لا نستطيع تحديدها في المحاولة الأولى تعود مع "status": "unknown" وwarning، وتكتمل بياناتها خلال دقائق مع تشغيل إعادة الاستعلام.

يعمل المفتاح نفسه عبر عائلة المنتجات حيثما يقبل المنتج بيانات اعتماد العائلة. اقرأ دليل المصادقة للصورة الكاملة حول البادئات والترويسات.

الخطوات التالية