პაკინგის API

სწრაფი დაწყება

1. შესვლა → დააჭირეთ თქვენს სახელზე → API → გენერირება გასაღების.
2. გაგზავნეთ პაკინგის დავალება (ეს სენდბოქსში სრულდება — უფასოა ყველა ტარიფზე):

curl -X POST https://hansatic.com/api/v1/pack \
  -H "Authorization: Bearer hk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "vehicle": "CURTAINSIDER_136",
    "objective": "ldm",
    "sandbox": true,
    "items": [{
      "name": "Machine crate",
      "length": 2300, "width": 750, "height": 1400,
      "weight": 300, "quantity": 7,
      "stackable": false, "tiltable": false
    }]
  }'

{
  "job_id": "5e3617d1-abe4-4549-b7e6-d18c6baf814f",
  "status": "queued",
  "sandbox": true,
  "status_url": "https://hansatic.com/api/v1/jobs/5e3617d1-..."
}

გამოკითხვა status_url-ზე (იგივე ავტორიზაციის ჰედერი) სანამ status არ გახდება "done":

{
  "job_id": "5e3617d1-...",
  "status": "done",
  "result": {
    "placed_count": 7,
    "unplaced_count": 0,
    "units": "metric",
    "metrics": {
      "ldm_m": 5.25,
      "span_mm": 5250,
      "linear_ft": 17.2,
      "pallet_positions_eur": 14,
      "total_weight_kg": 2100,
      "overlaps": 0
    },
    "items": [
      { "id": "...", "name": "Machine crate", "placed": true,
        "x": 8370, "y": 0, "z": 0,
        "rotation_deg": 90, "tilt_deg": 0, "...": "..." }
    ],
    "plan_url": "https://hansatic.com/en/app/plans/..."
  }
}

ენდპოინტები

პასუხის ველდები

result ობიექტი დასრულებულ დავალებაზე:

ვერსიები და სტაბილურობა

კონტრაქტი ვერსიით არის მონიშნული მისამართში (/api/v1/). v1-ის ფარგლებში ცვლილებები მხოლოდ დამატებითია — ახალი არასავალდებულო მოთხოვნის ველდები, ახალი პასუხის ველდები, ახალი ტრანსპორტის კოდები და შეცდომების კოდები შეიძლება გამოჩნდეს, ხოლო კლიენტებმა უნდა იგნორირონ ველდები, რომლებსაც არ იცნობენ. არსებული ველდები არასდროს იცვლიან მნიშვნელობას ან ტიპს, და არაფერი არ იშლება. დამანგრეველი ცვლილება ნიშნავს ახალი ვერსიის მისამართს, ხოლო v1-ის მხარდაჭერა გაგრძელდება პარალელურად მინიმუმ 12 თვის განმავლობაში და გაუქმების შეტყობინება გაიგზავნება ელ. ფოსტით ყველა სამუშაო სივრცეში აქტიური გასაღებით.

მოთხოვნის ველდები

ერთეულის ველდები

ტრანსპორტის კოდები

გენერირებულია აქტიური ძრავის სპეციფიკაციებიდან. თქვენი სამუშაო სივრცის ფლოტის საკუთარი ტრანსპორტი მუშაობს custom_vehicle_id-ის საშუალებით.

სატვირთო მანქანები და ტრეილერები

კონტეინერები

წვდომის დონეები და ლიმიტები

მხოლოდ წარმატებული პაკეტები ითვლება — არასწორი ვალიდაცია და წარუმატებელი დავალებები კვოტას არ ამცირებს. ორივე лічильник იბრუნებს საწყის მდგომარეობას 1-ელ რიცხვს (UTC). სენდბოქსის შედეგები სრული და შეუზღუდავია — ლიმიტი წარმოადგენს შეზღუდვას, არა შედეგს. გჭირდებათ 5,000-ზე მეტი პაკეტი თვეში? დაგვიკავშირდით მოცულობითი და OEM ფასების შესახებ.

ვებჰუკები

გადაეცით callback_url, რომ მიიღოთ შედეგი POST-ით დავალების დასრულებისას. ყოველ ვებჰუკს თან ახლავს X-Hansatic-Signature: HMAC-SHA256 ხელმოწერა ნედლი ტექსტისთვის თქვენი გასაღების ვებჰუკის საიდუმლოებით (ნაჩვენებია ერთხელ გასაღების შექმნისას). შეამოწმეთ ის:

const crypto = require('crypto');

function verify(rawBody, signatureHeader, webhookSecret) {
  const expected = crypto.createHmac('sha256', webhookSecret)
    .update(rawBody).digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(expected), Buffer.from(signatureHeader));
}

გაგზავნა ხდება ერთი მცდელობით 5 წამიანი ტაიმაუტით — status_url ყოველთვის რჩება ჭეშმარიტების წყაროდ.

შეცდომები

ყველა შეცდომა არის { "error": { "code", "message", ... } } ფორმატის — მანქანურად წაკითხვადი კოდი, ადამიანისთვის გასაგები შეტყობინება და field, თუ კონკრეტული შეყვანის ველია დამნაშავე.