Pakavimo API

Greitas pradžiamokslis

1. Prisijunkite → spustelėkite savo vardą → API → sugeneruokite raktą.
2. Pateikite pakavimo užduotį (ši veikia sandbox režime — nemokamai kiekviename plane):

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

Periodiškai tikrinkite status_url (su tuo pačiu autentifikacijos antraštės raktu), kol status bus "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/..."
  }
}

Galutiniai taškai

Atsakymo laukai

result objektas baigtoje užduotyje:

Versijavimas ir stabilumas

Sutartis versijuojama kelio (/api/v1/) lygmeniu. v1 versijoje pakeitimai yra tik papildomi — nauji neprivalomi užklausos laukai, nauji atsakymo laukai, nauji transporto priemonių kodai ir klaidų kodai gali pasirodyti, o klientai turėtų ignoruoti jiems nežinomus laukus. Esami laukai niekada nekeičia reikšmės ar tipo, ir niekas nėra pašalinama. Esminis pakeitimas reiškia naują versijos kelią, o v1 versija palaikoma lygiagrečiai bent 12 mėnesių ir apie išėjimą iš naudojimo pranešama el. paštu kiekvienai darbo erdveii, turinčiai aktyvų raktą.

Užklausos laukai

Daiktų laukai

Transporto priemonių kodai

Sugeneruota iš veikiančio variklio specifikacijų. Jūsų darbo erdvės flotilės transporto priemonės veikia per custom_vehicle_id.

Sunkvežimiai ir priekabos

Konteineriai

Prieigos lygiai ir apribojimai

Skaičiuojamos tik sėkmingai suformuotos pakuotės — netinkami užklausos duomenys ir nepavykę darbai į kvotą neįskaičiuojami. Abu skaitikliai atnaujinami kiekvieno mėnesio 1-ąją (UTC). Bandomojoje aplinkoje rezultatai yra pilni ir neapriboti — ribojamas tik kvotos dydis, o ne funkcionalumas. Reikia daugiau nei 5 000 pakuočių per mėnesį? Susisiekite su mumis dėl didesnių apimčių ir OEM kainodaros.

Webhook'ai

Nurodykite callback_url, kad gautumėte rezultatą POST metodu, kai užduotis bus baigta. Kiekvienas atgalinis iškvietimas turi X-Hansatic-Signature: HMAC-SHA256 parašą iš žinutės kūno su jūsų rakto webhook paslaptimi (rodoma tik kartą, kai raktas sukuriamas). Patvirtinkite ją:

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

Pristatymas vykdomas vieną kartą su 5 s laukimo laiku — status_url visada lieka pagrindiniu tiesos šaltiniu.

Klaidos

Visos klaidos yra { "error": { "code", "message", ... } } formato — mašininiu būdu skaitomas kodas, žmogui suprantama žinutė ir field, jei klaida susijusi su konkrečiu įvesties lauku.