Skip to content
Navo24 Navo24
무료로 시작하기

시작하기

시작하기

컨테이너 추적 API 빠른 시작: 키 없이 2분 만에 첫 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는 ETA가 예측값인 동안 true, 실제 도착 시각이 되면 false, ETA가 전혀 없으면 null입니다. 날짜만으로는 보장이 아닙니다.
  • 이벤트의 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이 함께 반환되며, 재조회가 실행되면 몇 분 안에 정보가 채워집니다.

제품이 패밀리 공통 자격 증명을 허용하는 경우 같은 키를 패밀리 전체에서 사용할 수 있습니다. 접두사와 헤더에 대한 전체 내용은 인증 가이드를 참고하세요.

다음 단계