Packing API

Hitri začetek

1. Prijavite se → kliknite na svoje ime → API → ustvarite ključ.
2. Oddajte nalogo za pakiranje (ta se izvaja v peskovniku — brezplačno na vsakem paketu):

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

Ponavljajte poizvedbe na status_url (enaka avtentikacijska glava) dokler status ni "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/..."
  }
}

Končne točke

Polja odgovora

Objekt result končane naloge:

Verzioniranje in stabilnost

Pogodba je verzionirana v poti (/api/v1/). Znotraj v1 so spremembe izključno aditivne — novi neobvezni polji zahteve, nova polja odgovora, nove kode vozil in napake se lahko pojavijo, stranke pa naj prezrejo polja, ki jih ne prepoznajo. Obstoječa polja nikoli ne spremenijo pomena ali tipa, ničesar pa se ne odstrani. Prekinitev združljivosti pomeni novo verzijo poti, pri čemer se v1 vzdržuje vzporedno vsaj 12 mesecev in obvestilo o opuščanju pošlje na e-pošto vsakega delovnega prostora z aktivnim ključem.

Polja zahteve

Polja izdelkov

Kode vozil

Ustvarjene iz specifikacij aktivnega motorja. Prilagojena vozila iz vaše flote delovnega prostora delujejo prek custom_vehicle_id.

Tovornjaki in prikolice

Kontejnerji

Razredi dostopa in omejitve

Štejejo se le uspešno zaključena pakiranja — neuspešne validacije in neuspešne naloge nikoli ne zaračunavamo v kvoto. Oba števca se ponastavita 1. dne (UTC). Rezultati v peskovniku so popolni in neokrnjeni — omejitve so le meja, ne pa tudi izhoda. Potrebujete več kot 5.000 pakiranj na mesec? Oglejte si možnosti za večje količine in cene OEM.

Spletni klici

Podajte callback_url, da prejmete rezultat prek POST, ko se naloga zaključi. Vsak klic vsebuje X-Hansatic-Signature: HMAC-SHA256 izvornega telesa s spletno skrivnostjo vašega ključa (prikazano enkrat ob ustvarjanju ključa). Preverite ga:

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

Dostava je en poskus s časovno omejitvijo 5 s — status_url vedno ostane vir resnice.

Napake

Vse napake so { "error": { "code", "message", ... } } — strojno berljiva koda, razumljivo sporočilo za človeka in field, če je vzrok določeno vhodno polje.