Packing API

Brzi početak

1. Prijavite se → kliknite na svoje ime → API → generišite ključ.
2. Pošaljite zahtev za pakovanje (ovaj se izvršava u sandbox-u — besplatan na svakom 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-..."
}

Pitajte status_url (sa istim zaglavljem za autentifikaciju) sve dok status ne bude "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/..."
  }
}

Endpoint-i

Polja odgovora

Objekat result na završenom poslu:

Verzioniranje i stabilnost

Ugovor je verzionisan u putanji (/api/v1/). Unutar v1, promene su samo dodatne — novi opcioni polja zahteva, nova polja odgovora, novi kodovi vozila i kodovi grešaka mogu se pojaviti, a klijenti treba da ignorišu polja koja ne prepoznaju. Postojeća polja nikada ne menjaju značenje ili tip, i ništa se ne uklanja. Breaking change znači novu verziju putanje, pri čemu se v1 održava paralelno najmanje 12 meseci uz obaveštenje o zastarelosti putem mejla svakom radnom prostoru sa aktivnim ključem.

Polja zahteva

Polja predmeta

Kodovi vozila

Generisani iz specifikacija aktivnog sistema. Prilagođena vozila iz vaše flote radnog prostora rade preko custom_vehicle_id.

Kamioni i prikolice

Kontejneri

Nivoi pristupa i ograničenja

Broje se samo uspešna pakovanja — neuspešne validacije i neuspešni poslovi nikada se ne obračunavaju prema kvoti. Oba brojača se resetuju 1. u mesecu (UTC). Rezultati u sandbox okruženju su potpuni i neograničeni — granice su filter, a ne izlaz. Potrebno vam je više od 5.000 pakovanja mesečno? Razgovarajte sa nama o cenama za veće količine i OEM licencama.

Webhook-ovi

Prosledite callback_url da biste primili rezultat PUT zahtevom kada posao bude završen. Svaki poziv sadrži X-Hansatic-Signature: HMAC-SHA256 potpisa sirovog tela sa tajnim ključem za webhook-ove vašeg ključa (prikazan jednom prilikom kreiranja ključa). Verifikujte 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));
}

Isporuka je jedan pokušaj sa vremenskim ograničenjem od 5s — status_url uvek ostaje izvor istine.

Greške

Sve greške su { "error": { "code", "message", ... } } — mašinski čitljiv kod, čitljiva poruka za čoveka i field kada je određeni ulazni podatak neispravan.