Packing API

Fillimi i shpejtë

1. Hyni → klikoni emrin tuaj → API → gjeneroni një çelës.
2. Dërgoni një punë paketimi (kjo ekzekutohet në sandbox — falas në çdo plan):

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

Pyeteni status_url (me të njëjtin header autentikimi) derisa status të jetë "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/..."
  }
}

Pikat fundore

Fusha të përgjigjes

Objekti result për një punë të përfunduar:

Versionim & stabilitet

Kontrata versionohet në rrugën (/api/v1/). Brenda v1, ndryshimet janë vetëm shtuese — fusha të reja opsionale në kërkesë, fusha të reja në përgjigje, kode të reja automjetesh dhe kode gabimi mund të shfaqen, dhe klientët duhet të injorojnë fushat që nuk i njohin. Fushat ekzistuese nuk ndryshojnë kurrë kuptim ose lloj, dhe asgjë nuk hiqet. Një ndryshim thyesor nënkupton një rrugë versioni të re, me v1 të mbajtur paralelisht për të paktën 12 muaj dhe njoftim për heqje me email për çdo hapësirë pune me një çelës aktiv.

Fusha të kërkesës

Fusha të artikujve

Kodet e automjeteve

Të gjeneruara nga specifikimet e makinës aktive. Automjetet personalizuar nga flota juaj në hapësirën e punës funksionojnë përmes custom_vehicle_id.

Kamionë & rimorkio

Kontejnerë

Nivele qasjeje & kufizime

Numërohen vetëm paketimet e suksesshme — validimet e dështuara dhe punët e dështuara nuk llogariten në kuotë. Të dyja numëruesit rivendosen më 1-tën (UTC). Rezultatet në sandbox janë të plota dhe pa kufizime — kufijtë janë porta, jo rezultati. Ju duhen më shumë se 5,000 paketime në muaj? Kontaktoni për çmime volumetrike dhe OEM.

Webhooks

Kaloni callback_url për të marrë rezultatin përmes POST kur puna përfundon. Çdo callback mbart X-Hansatic-Signature: një HMAC-SHA256 i trupit të papërpunuar me sekretin e webhook-ut të çelësit tuaj (shfaqet një herë gjatë krijimit të çelësit). Verifikojeni:

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

Dërgimi bëhet në një përpjekje me kohëzgjatje 5s — status_url mbetet gjithmonë burimi i së vërtetës.

Gabime

Të gjitha gabimet janë { "error": { "code", "message", ... } } — kod i lexueshëm nga makina, mesazh i lexueshëm nga njeriu, dhe field kur një hyrje specifike është fajtor.