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, והנתונים שלה מתמלאים תוך דקות כשהבדיקה החוזרת רצה.

אותו מפתח עובד בכל משפחת המוצרים, בכל מקום שבו מוצר מקבל את אישור הגישה המשפחתי. קראו את מדריך האימות לתמונה המלאה על קידומות וכותרות.

לאן ממשיכים