Pakolási API

Gyors kezdés

1. Jelentkezzen be → kattintson a nevére → API → generáljon kulcsot.
2. Küldjön el egy pakolási feladatot (ez sandbox módban fut — ingyenes minden csomagban):

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-..."
}

Kérdezze le a status_url címet (ugyanazzal a hitelesítési fejléccel), amíg a status értéke "done" nem lesz:

{
  "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/..."
  }
}

Végpontok

Válaszmezők

A result objektum egy befejezett feladat esetén:

Verziókezelés és stabilitás

A szerződés verziószáma az elérési útban szerepel (/api/v1/). A v1-en belül a változtatások csak bővítések lehetnek — új, opcionális kérési mezők, új válaszmezők, új járműkódok és hibakódok jelenhetnek meg, amelyeket a klienseknek figyelmen kívül kell hagyniuk, ha nem ismerik fel őket. A meglévő mezők jelentése és típusa soha nem változik, és semmi nem kerül törlésre. A törő változtatás új verzióelérési utat jelent, a v1-es változatot pedig legalább 12 hónapon át párhuzamosan fenntartják, és minden olyan munkaterületnek e-mailben küldenek értesítést a leállásról, amelynek aktív kulcsa van.

Kérési mezők

Tételek mezői

Járműkódok

A valós motor specifikációiból generálva. A munkaterület flottákészletéből származó egyedi járművek a custom_vehicle_id segítségével működnek.

Teherautók és pótkocsik

Konténerek

Hozzáférési szintek és korlátok

Csak a sikeres pakolások számítanak – a validálási és végrehajtási hibák nem terhelik a kvótát. Mindkét számláló az hónap 1. napján (UTC) nullázódik. A tesztkörnyezet eredményei teljes értékűek és korlátozások nélkül állnak rendelkezésre – a limit csak a belépési küszöb, nem a kimenet. Több mint 5 000 pakolásra van szüksége havonta? Beszéljen velünk a nagyvolumenű és OEM árazási lehetőségekről.

Webhookok

Adja meg a callback_url címet, hogy a feladat befejezésekor POST kéréssel megkapja az eredményt. Minden visszahívás tartalmazza a X-Hansatic-Signature aláírást: a nyers törzs HMAC-SHA256 kódolású aláírását a kulcs webhook titkos kulcsával (amelyet a kulcs létrehozásakor egyszer mutatnak meg). Ellenőrizze ezt:

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));
}

Az elküldés egy próbálkozásból áll, 5s időtúllépéssel — a status_url mindig a forrásigazság marad.

Hibák

Minden hiba { "error": { "code", "message", ... } } formátumú — gép által olvasható kód, ember által olvasható üzenet, és field, ha egy konkrét bemenet a hibás.