Skip to content
Navo24Navo24
無料で始める

はじめに

はじめに

コンテナ追跡 API のクイックスタート。キー不要で 2 分以内に最初の Navo24 呼び出しを行い、その後 API キーを取得して貨物を追跡します。

Navo24 は直接呼び出せる物流インテリジェンスです。コンテナと航空貨物運送状 (AWB) の追跡、配船スケジュールと定時性、スポット運賃、積載計画を提供します。各プロダクトは REST API を備え、ほとんどは MCP サーバーも備えており、すべて 1 つの 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
      }
    ]
  }
}

意味の大部分は次の 4 つのフィールドが担っています。

  • 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 の 2 つの必須フィールドがあります。種類は 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 付きで返され、再ポーリングが実行されると数分以内にデータが埋まります。

プロダクトがファミリー共通の認証情報を受け付ける場合、同じキーをファミリー全体で使用できます。プレフィックスとヘッダーの全体像は認証ガイドをご覧ください。

次のステップ