Packing API

Mabilis na pagsisimula

1. Mag-sign in → i-click ang iyong pangalan → API → bumuo ng key.
2. Magsumite ng pack job (ito ay tumatakbo sa sandbox — libre sa bawat plano):

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

Suriin ang status_url (gamit ang parehong auth header) hanggang ang status ay "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/..."
  }
}

Mga endpoint

Mga field ng tugon

Ang result object sa isang natapos na job:

Bersyon at katatagan

Ang kontrata ay naka-versyon sa path (/api/v1/). Sa loob ng v1, ang mga pagbabago ay additive lamang — bagong opsyonal na field sa kahilingan, bagong field sa tugon, bagong vehicle code at error code ay maaaring lumitaw, at dapat balewalain ng mga kliyente ang mga field na hindi nila nakikilala. Hindi kailanman nagbabago ang kahulugan o uri ng mga umiiral na field, at walang anumang inaalis. Ang isang breaking change ay nangangahulugan ng bagong version path, na may v1 na pinapanatili nang magkatabi sa loob ng hindi bababa sa 12 buwan at abiso ng deprecation sa email sa bawat workspace na may aktibong key.

Mga field ng kahilingan

Mga field ng item

Mga vehicle code

Nagmumula sa mga spec ng live engine. Gumagana ang mga custom na sasakyan mula sa iyong workspace fleet sa pamamagitan ng custom_vehicle_id.

Mga trak at trailer

Mga container

Mga antas ng access at limitasyon

Tanging matagumpay na pag-iimpake lamang ang binibilang — nabigong pagpapatunay at nabigong trabaho ay hindi ibinabawas sa quota. Ang parehong counter ay nagre-reset sa ika-1 (UTC). Ang mga resulta sa sandbox ay kumpleto at walang limitasyon — ang mga limitasyon ang hadlang, hindi ang output. Kailangan mo ba ng higit sa 5,000 pag-iimpake sa isang buwan? Makipag-ugnayan sa amin tungkol sa volume at presyong OEM.

Webhooks

I-pasa ang callback_url para matanggap ang resulta sa pamamagitan ng POST kapag natapos na ang job. Bawat callback ay may kasamang X-Hansatic-Signature: isang HMAC-SHA256 ng raw body gamit ang webhook secret ng iyong key (ipinapakita nang isang beses sa paggawa ng key). Patunayan ito:

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

Isang pagtatangka lamang ang paghahatid na may 5s timeout — ang status_url ay laging nananatiling pinagmulan ng katotohanan.

Mga error

Lahat ng error ay { "error": { "code", "message", ... } } — machine-readable na code, mababasang mensahe, at field kapag may partikular na input na may problema.