Packing API

Mula pantas

1. Log masuk → klik nama anda → API → hasilkan kunci.
2. Hantar tugas pemuatan (tugas ini berjalan dalam sandbox — percuma dalam setiap pelan):

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

Semak status_url (dengan pengepala pengesahan yang sama) sehingga status ialah "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/..."
  }
}

Titik akhir

Medan respons

Objek result untuk tugas yang selesai:

Versi & kestabilan

Kontrak versi dalam laluan (/api/v1/). Dalam v1, perubahan hanya bersifat tambahan — medan permintaan pilihan baharu, medan respons baharu, kod kenderaan baharu dan kod ralat baharu mungkin muncul, dan klien harus mengabaikan medan yang tidak dikenali. Medan sedia ada tidak akan mengubah maksud atau jenis, dan tiada apa yang akan dikeluarkan. Perubahan memecahkan bermakna laluan versi baharu, dengan v1 dikekalkan selari sekurang-kurangnya 12 bulan dan notis penamatan dihantar melalui e-mel kepada setiap ruang kerja dengan kunci aktif.

Medan permintaan

Medan item

Kod kenderaan

Dihasilkan dari spesifikasi enjin langsung. Kenderaan tersuai dari armada ruang kerja anda berfungsi melalui custom_vehicle_id.

Trak & treler

Kontena

Tahap akses & had

Hanya pek yang berjaya dikira — pek yang gagal disahkan dan tugasan yang gagal tidak akan dikenakan terhadap kuota. Kedua-dua pembilang akan ditetapkan semula pada hari ke-1 (UTC). Keputusan kotak pasir adalah lengkap dan tidak terhad — had ini adalah pintu masuk, bukan output. Perlu lebih daripada 5,000 pek sebulan? Hubungi kami untuk membincangkan harga volum dan OEM.

Webhook

Hantar callback_url untuk menerima hasil melalui POST apabila tugas selesai. Setiap panggilan balik membawa X-Hansatic-Signature: HMAC-SHA256 bagi badan mentah dengan rahsia webhook kunci anda (ditunjukkan sekali semasa penciptaan kunci). Sahkan:

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

Penghantaran adalah satu percubaan dengan masa tamat 5s — status_url sentiasa kekal sebagai sumber kebenaran.

Ralat

Semua ralat adalah { "error": { "code", "message", ... } } — kod yang boleh dibaca mesin, mesej yang boleh dibaca manusia, dan field apabila input tertentu salah.