Skip to content
Navo24 Navo24
დაიწყეთ უფასოდ

დაწყება

დაწყება

კონტეინერების თვალყურის დევნების API სწრაფად: პირველი Navo24 მოთხოვნა ორ წუთში გასაღების გარეშე, შემდეგ API გასაღები და ტვირთის თვალყურის დევნება.

Navo24 არის სატვირთო ანალიტიკა, რომელსაც პირდაპირ იძახებთ: კონტეინერებისა და საჰაერო ზედნადებების თვალყურის დევნება, რეისების განრიგი და საიმედოობა, სპოტ ტარიფები და დატვირთვის დაგეგმვა. თითოეულ პროდუქტს აქვს REST API, უმეტესობას კი MCP სერვერიც, და ყველა ერთი bearer გასაღებით მუშაობს.

გააკეთეთ მოთხოვნა ანგარიშის გარეშე

რეალური მონაცემების სანახავად ყველაზე სწრაფი გზაა კონტეინერების თვალყურის დევნების API-ის საჯარო endpoint. მას გასაღები არ სჭირდება.

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": []
  }
}

დაიწყეთ ტვირთის თვალყურის დევნება

გასაღებიან ინტერფეისს ორი სავალდებულო ველი სჭირდება: 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-ით, და რამდენიმე წუთში ივსება, როცა განმეორებითი შემოწმება გაეშვება.

იგივე გასაღები მუშაობს მთელ ოჯახში, სადაც პროდუქტი ოჯახის საერთო ავტორიზაციას იღებს. პრეფიქსებისა და ჰედერების სრული სურათისთვის წაიკითხეთ ავთენტიფიკაციის სახელმძღვანელო.

სად წავიდეთ შემდეგ