Skip to content
Navo24Navo24
เริ่มใช้ฟรี

เริ่มต้นใช้งาน

เริ่มต้นใช้งาน

เริ่มต้นใช้ API ติดตามตู้คอนเทนเนอร์: เรียก Navo24 ครั้งแรกภายในสองนาทีโดยไม่ต้องใช้คีย์ จากนั้นรับ API key และติดตามชิปเมนต์

Navo24 คือข้อมูลอัจฉริยะด้านการขนส่งสินค้าที่คุณเรียกใช้ได้โดยตรง ได้แก่ การติดตามตู้คอนเทนเนอร์และใบตราส่งสินค้าทางอากาศ ตารางเดินเรือและความตรงต่อเวลา ค่าระวางสปอต และการวางแผนการบรรจุ ทุกผลิตภัณฑ์มี REST API และส่วนใหญ่มีเซิร์ฟเวอร์ MCP ด้วย โดยใช้ bearer key เพียงคีย์เดียว

เรียกใช้โดยไม่ต้องมีบัญชี

วิธีที่เร็วที่สุดในการดูข้อมูลจริงคือ 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 เป็น true ขณะที่ ETA ยังเป็นค่าคาดการณ์ เป็น false เมื่อเป็นเวลาถึงจริง และเป็น null เมื่อเราไม่มี ETA เลย วันที่เพียงอย่างเดียวไม่ใช่คำมั่นสัญญา
  • actual ในเหตุการณ์เป็น true สำหรับสิ่งที่เกิดขึ้นแล้ว และ false สำหรับสิ่งที่วางแผนไว้ อย่าตีความการเคลื่อนย้ายที่วางแผนไว้ว่าเป็นข้อเท็จจริง
  • carrier_code, origin, destination และ unlocode จะเป็น null เมื่อสายการเดินเรือไม่ได้ระบุสิ่งที่เราสามารถระบุตัวตนได้ แทนที่จะเดาค่า

endpoint สาธารณะมีการจำกัดอัตราต่อ IP และมีไว้สำหรับการตรวจสอบอย่างรวดเร็ว การใช้งานที่ต้องดูแลชิปเมนต์จำนวนมากต้องใช้คีย์

รับ API key

  1. สมัครใช้งานที่ trackingmcp.com
  2. เปิดการตั้งค่าสำหรับนักพัฒนาแล้วสร้างคีย์ คีย์จะมีคำนำหน้าของผลิตภัณฑ์ เช่น tmcp_ สำหรับการติดตาม
  3. ส่งคีย์เป็น bearer token ในทุกคำขอที่ต้องยืนยันตัวตน
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": []
  }
}

เริ่มติดตามชิปเมนต์

endpoint ที่ใช้คีย์ต้องการฟิลด์บังคับสองฟิลด์ คือ 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 และข้อมูลจะถูกเติมภายในไม่กี่นาทีเมื่อการดึงข้อมูลซ้ำทำงาน

คีย์เดียวกันใช้ได้กับทุกผลิตภัณฑ์ในตระกูลที่รองรับข้อมูลรับรองร่วมของตระกูล อ่านคู่มือการยืนยันตัวตนเพื่อดูภาพรวมทั้งหมดเกี่ยวกับคำนำหน้าและเฮดเดอร์

ขั้นตอนถัดไป