Skip to content
Navo24Navo24
Bắt đầu miễn phí

Bắt đầu

Bắt đầu

Bắt đầu nhanh với API theo dõi container: gọi Navo24 lần đầu trong hai phút không cần khóa, sau đó lấy API key và theo dõi một lô hàng.

Navo24 là dữ liệu thông minh về vận tải hàng hóa mà bạn gọi trực tiếp: theo dõi container và vận đơn hàng không, lịch tàu và độ đúng giờ, cước giao ngay và lập kế hoạch xếp hàng. Mỗi sản phẩm đều có REST API, phần lớn còn có máy chủ MCP, tất cả dùng chung một bearer key.

Gọi API mà không cần tài khoản

Cách nhanh nhất để xem dữ liệu thật là endpoint công khai của API theo dõi container. Endpoint này không cần khóa.

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

Bạn nhận về trạng thái đã chuẩn hóa, tàu, các mốc sự kiện và ETA kèm cho biết đó có còn là dự báo hay không:

{
  "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
      }
    ]
  }
}

Bốn trường mang phần lớn ý nghĩa:

  • identifier_type là loại mà chúng tôi xác định cho mã tham chiếu, có thể khác với phỏng đoán của bạn.
  • eta_is_estimated là true khi ETA còn là dự báo, false khi đó là thời điểm đến thực tế và null khi chúng tôi không có ETA nào. Một ngày đơn thuần không phải là cam kết.
  • actual trong một sự kiện là true với việc đã xảy ra và false với việc đã lên kế hoạch. Đừng bao giờ coi một hoạt động dự kiến là sự thật.
  • carrier_code, origin, destination và unlocode là null khi hãng vận chuyển không cung cấp thông tin nào chúng tôi có thể xác định, thay vì đoán.

Endpoint công khai bị giới hạn tần suất theo IP và chỉ dùng để kiểm tra nhanh. Mọi nhu cầu theo dõi nhiều lô hàng đều cần khóa.

Lấy API key

  1. Đăng ký tại trackingmcp.com.
  2. Mở phần cài đặt dành cho nhà phát triển và tạo khóa. Khóa có tiền tố theo sản phẩm, ví dụ tmcp_ cho theo dõi.
  3. Gửi khóa dưới dạng bearer token trong mọi yêu cầu cần xác thực.
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": []
  }
}

Bắt đầu theo dõi một lô hàng

Các endpoint dùng khóa yêu cầu hai trường bắt buộc là identifier và identifier_type. Loại là một trong container_id, bill_of_lading hoặc 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"
  }
}

Hãy lưu lại id. Đây là một UUID và mọi endpoint container khác đều dùng giá trị này làm khóa thay vì số container. Container được chấp nhận nhưng chưa xác định được ở lần đầu sẽ trả về "status": "unknown" cùng một warning, và dữ liệu sẽ được bổ sung trong vài phút khi quá trình truy vấn lại chạy.

Cùng một khóa dùng được cho cả nhóm sản phẩm khi sản phẩm chấp nhận thông tin xác thực chung của nhóm. Đọc hướng dẫn xác thực để nắm đầy đủ về tiền tố và header.

Bước tiếp theo