Skip to content
Navo24Navo24
Zacznij za darmo

Pierwsze kroki

Pierwsze kroki

Szybki start z API śledzenia kontenerów: pierwsze wywołanie Navo24 w dwie minuty bez klucza, potem klucz API i śledzona przesyłka.

Navo24 to dane frachtowe, które wywołujesz bezpośrednio: śledzenie kontenerów i lotniczych listów przewozowych (AWB), rozkłady rejsów i ich punktualność, stawki spot oraz planowanie załadunku. Każdy produkt udostępnia REST API, a większość także serwer MCP, wszystko za jednym kluczem bearer.

Wywołanie bez konta

Najszybszy sposób, by zobaczyć prawdziwe dane, to publiczny endpoint API śledzenia kontenerów. Nie wymaga klucza.

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

W odpowiedzi dostajesz znormalizowany status, statek, kamienie milowe i ETA z informacją, czy to wciąż prognoza:

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

Najwięcej znaczenia niosą cztery pola:

  • identifier_type mówi, czym według nas faktycznie jest dany numer referencyjny. Może to się różnić od Twojego założenia.
  • eta_is_estimated ma wartość true, dopóki ETA jest prognozą, false, gdy jest to rzeczywisty czas przybycia, oraz null, gdy nie mamy żadnego ETA. Sama data nie jest obietnicą.
  • actual w zdarzeniu ma wartość true dla czegoś, co się wydarzyło, i false dla czegoś zaplanowanego. Nigdy nie traktuj zaplanowanego ruchu jako faktu.
  • carrier_code, origin, destination i unlocode mają wartość null, gdy przewoźnik nie podał niczego, co moglibyśmy rozpoznać. Nie zgadujemy tych wartości.

Publiczne endpointy mają limit zapytań na adres IP i służą do szybkiego sprawdzenia. Do obsługi całego portfela potrzebny jest klucz.

Uzyskaj klucz API

  1. Zarejestruj się na trackingmcp.com.
  2. Otwórz ustawienia dewelopera i wygeneruj klucz. Ma on prefiks produktu, na przykład tmcp_ dla śledzenia.
  3. Wysyłaj go jako token bearer w każdym uwierzytelnionym żądaniu.
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": []
  }
}

Zacznij śledzić przesyłkę

Endpointy wymagające klucza przyjmują dwa obowiązkowe pola: identifier i identifier_type. Typ to jedna z wartości: container_id, bill_of_lading lub 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"
  }
}

Zachowaj id. To UUID, a wszystkie pozostałe endpointy kontenerów używają go jako klucza zamiast numeru kontenera. Kontener, który przyjmiemy, ale nie zdołamy rozpoznać za pierwszym razem, wraca z "status": "unknown" i polem warning, a dane uzupełniają się w ciągu kilku minut, gdy działa ponowne odpytywanie.

Ten sam klucz działa w całej rodzinie produktów, o ile dany produkt akceptuje wspólne poświadczenia. Pełny opis prefiksów i nagłówków znajdziesz w poradniku uwierzytelniania.

Co dalej