Skip to content
Navo24Navo24
Kostenlos starten

Erste Schritte

Erste Schritte

Schnellstart für die Container-Tracking-API: Ihr erster Navo24-Aufruf in zwei Minuten ohne Key, danach ein API-Key und eine verfolgte Sendung.

Navo24 ist Fracht-Intelligence, die Sie direkt aufrufen: Container- und Luftfrachtbrief-Tracking, Fahrpläne und Fahrplanzuverlässigkeit, Spot-Raten und Ladeplanung. Jedes Produkt bietet eine REST-API, die meisten zusätzlich einen MCP-Server, alles hinter einem einzigen Bearer-Key.

Ein Aufruf ohne Konto

Am schnellsten sehen Sie echte Daten über den öffentlichen Endpunkt der Container-Tracking-API. Dafür ist kein Key nötig.

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

Sie erhalten einen normalisierten Status, das Schiff, die Meilensteine und eine ETA, die angibt, ob es sich noch um eine Prognose handelt:

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

Vier Felder tragen den Großteil der Aussage:

  • identifier_type gibt an, als was wir die Referenz tatsächlich erkannt haben. Das kann von Ihrer Annahme abweichen.
  • eta_is_estimated ist true, solange die ETA eine Prognose ist, false, sobald es die tatsächliche Ankunft ist, und null, wenn uns gar keine ETA vorliegt. Ein Datum allein ist kein Versprechen.
  • actual ist bei einem Ereignis true für etwas, das stattgefunden hat, und false für etwas Geplantes. Werten Sie eine geplante Bewegung nie als Tatsache.
  • carrier_code, origin, destination und unlocode sind null, wenn die Reederei nichts angegeben hat, das wir auflösen konnten, statt geraten zu werden.

Öffentliche Endpunkte sind pro IP rate-limitiert und für eine schnelle Prüfung gedacht. Alles im Portfolio-Maßstab braucht einen Key.

API-Key erhalten

  1. Registrieren Sie sich auf trackingmcp.com.
  2. Öffnen Sie die Entwicklereinstellungen und erstellen Sie einen Key. Er trägt ein Produktpräfix, zum Beispiel tmcp_ für Tracking.
  3. Senden Sie ihn bei jeder authentifizierten Anfrage als 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": []
  }
}

Eine Sendung verfolgen

Die Key-geschützte Schnittstelle erwartet zwei Pflichtfelder, identifier und identifier_type. Der Typ ist einer von container_id, bill_of_lading oder 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"
  }
}

Speichern Sie die id. Sie ist eine UUID, und alle weiteren Container-Endpunkte arbeiten mit ihr statt mit der Containernummer. Ein Container, den wir annehmen, aber im ersten Durchlauf nicht auflösen können, kommt mit "status": "unknown" und einer warning zurück und wird innerhalb weniger Minuten ergänzt, sobald die erneute Abfrage läuft.

Derselbe Key funktioniert in der gesamten Produktfamilie, sofern ein Produkt die gemeinsamen Zugangsdaten akzeptiert. Alle Details zu Präfixen und Headern finden Sie in der Anleitung zur Authentifizierung.

Wie geht es weiter