Skip to content
Navo24Navo24
Ücretsiz başlayın

Başlarken

Başlarken

Konteyner takip API'si hızlı başlangıç: anahtarsız ilk Navo24 çağrınız iki dakikada, ardından bir API anahtarı ve takip edilen bir sevkiyat.

Navo24, doğrudan çağırdığınız bir navlun zekâsıdır: konteyner ve hava konşimentosu takibi, sefer tarifeleri ve güvenilirlik, spot navlun fiyatları ve yükleme planlaması. Her ürün bir REST API ile gelir, çoğunda ayrıca bir MCP sunucusu da vardır ve hepsi tek bir bearer anahtarın arkasındadır.

Hesap açmadan çağrı yapın

Gerçek veriyi görmenin en hızlı yolu, konteyner takip API’sinin herkese açık uç noktasıdır. Anahtar gerektirmez.

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

Yanıt olarak normalleştirilmiş bir durum, gemi, kilometre taşları ve hâlâ tahmin olup olmadığını belirten bir ETA alırsınız:

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

Anlamın büyük kısmını dört alan taşır:

  • identifier_type, referansın gerçekte ne olduğuna dair kararımızdır ve sizin tahmininizden farklı olabilir.
  • eta_is_estimated, ETA bir tahmin olduğu sürece true, gerçek varış olduğunda false, elimizde hiç ETA yoksa null olur. Tek başına bir tarih söz anlamına gelmez.
  • Bir olaydaki actual, gerçekleşmiş bir şey için true, planlanmış bir şey için false olur. Planlanmış bir hareketi asla gerçekleşmiş gibi okumayın.
  • carrier_code, origin, destination ve unlocode, taşıyıcı çözümleyebileceğimiz hiçbir şey belirtmediğinde tahmin yerine null döner.

Herkese açık uç noktalar IP başına hız sınırına tabidir ve hızlı bir kontrol içindir. Portföy ölçeğindeki her iş için bir anahtar gerekir.

API anahtarı alın

  1. trackingmcp.com adresinden kaydolun.
  2. Geliştirici ayarlarını açın ve bir anahtar oluşturun. Anahtar bir ürün önekiyle gelir, örneğin takip için tmcp_.
  3. Kimlik doğrulamalı her istekte onu bearer token olarak gönderin.
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": []
  }
}

Bir sevkiyatı takip etmeye başlayın

Anahtarlı arayüz iki zorunlu alan alır: identifier ve identifier_type. Tür container_id, bill_of_lading veya booking değerlerinden biridir.

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 değerini saklayın. Bu bir UUID’dir ve diğer tüm konteyner uç noktaları konteyner numarasıyla değil, bu değerle çalışır. Kabul ettiğimiz ancak ilk denemede çözümleyemediğimiz bir konteyner "status": "unknown" ve bir warning ile döner, yeniden sorgulama çalıştıkça birkaç dakika içinde dolar.

Bir ürünün aile kimlik bilgisini kabul ettiği her yerde aynı anahtar tüm ailede çalışır. Önekler ve başlıklarla ilgili tam tablo için kimlik doğrulama kılavuzunu okuyun.

Sırada ne var