Skip to content
Navo24Navo24
رایگان شروع کنید

شروع کار

شروع کار

شروع سریع API رهگیری کانتینر: اولین فراخوانی Navo24 در دو دقیقه و بدون کلید، سپس دریافت کلید API و رهگیری یک محموله.

Navo24 هوش حمل‌ونقلی است که مستقیم فراخوانی‌اش می‌کنید: رهگیری کانتینر و بارنامه هوایی، برنامه حرکت کشتی‌ها و میزان قابلیت اطمینان آن‌ها، نرخ‌های لحظه‌ای و برنامه‌ریزی بارگیری. هر محصول یک REST API دارد و بیشترشان یک سرور MCP هم دارند، همه با یک کلید bearer.

فراخوانی بدون حساب کاربری

سریع‌ترین راه برای دیدن داده واقعی، endpoint عمومی 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 تا وقتی ETA پیش‌بینی است true است، وقتی به زمان واقعی رسیدن تبدیل شد false می‌شود و اگر هیچ ETA نداشته باشیم null است. یک تاریخ به‌تنهایی تعهد نیست.
  • actual در یک رویداد برای اتفاقی که رخ داده true و برای اتفاق برنامه‌ریزی‌شده false است. هرگز جابه‌جایی برنامه‌ریزی‌شده را واقعیت فرض نکنید.
  • carrier_code، origin، destination و unlocode وقتی حمل‌کننده چیزی که بتوانیم شناسایی کنیم اعلام نکرده باشد null هستند، به‌جای اینکه حدس زده شوند.

endpointهای عمومی برای هر 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 است و همه endpointهای دیگر کانتینر بر اساس آن کار می‌کنند، نه شماره کانتینر. کانتینری که می‌پذیریم ولی در تلاش اول نمی‌توانیم شناسایی کنیم با "status": "unknown" و یک warning برمی‌گردد و با اجرای پرس‌وجوی مجدد، ظرف چند دقیقه اطلاعاتش کامل می‌شود.

هر جا محصولی اعتبارنامه خانواده محصولات را بپذیرد، همان کلید در کل خانواده کار می‌کند. برای تصویر کامل پیشوندها و هدرها راهنمای احراز هویت را بخوانید.

قدم بعدی