Skip to content
Navo24Navo24
Почати безкоштовно

Початок роботи

Початок роботи

Швидкий старт з API відстеження контейнерів: перший виклик Navo24 за дві хвилини без ключа, потім ключ API і відстежуване відправлення.

Navo24 це вантажна аналітика, до якої ви звертаєтеся напряму: відстеження контейнерів і авіанакладних (AWB), розклади рейсів та їхня надійність, спотові ставки і планування завантаження. Кожен продукт має REST API, а більшість ще й MCP-сервер, і все це за одним bearer-ключем.

Виклик без облікового запису

Найшвидший спосіб побачити реальні дані це публічний endpoint 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 дорівнює true, поки ETA є прогнозом, false, коли це фактичне прибуття, і null, коли ETA в нас немає зовсім. Сама дата ще не обіцянка.
  • actual у події дорівнює true для того, що відбулося, і false для запланованого. Ніколи не сприймайте запланований рух як факт.
  • carrier_code, origin, destination і unlocode дорівнюють null, коли перевізник не вказав нічого, що ми змогли б розпізнати. Ми не вгадуємо ці значення.

Публічні endpoint-и мають ліміт запитів на 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": []
  }
}

Почніть відстежувати відправлення

Endpoint-и з ключем приймають два обов’язкові поля: 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, і всі інші endpoint-и контейнерів використовують саме його як ключ, а не номер контейнера. Контейнер, який ми прийняли, але не змогли розпізнати з першої спроби, повертається з "status": "unknown" і полем warning, а дані заповнюються протягом кількох хвилин під час повторного опитування.

Той самий ключ працює в усій родині продуктів, якщо продукт приймає спільні облікові дані. Повну інформацію про префікси та заголовки дивіться в посібнику з автентифікації.

Що далі