Packing API

Mulai cepat

1. Masuk → klik nama Anda → API → buat kunci.
2. Kirimkan pekerjaan packing (contoh ini berjalan di sandbox — gratis di setiap paket):

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

Pantau status_url (dengan header autentikasi yang sama) hingga status menjadi "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

Field respons

Objek result pada pekerjaan yang selesai:

Versi & stabilitas

Kontrak diberi versi dalam path (/api/v1/). Dalam v1, perubahan hanya bersifat penambahan — field permintaan opsional baru, field respons baru, kode kendaraan baru, dan kode kesalahan baru dapat muncul, dan klien harus mengabaikan field yang tidak dikenali. Field yang ada tidak pernah mengubah arti atau tipe, dan tidak ada yang dihapus. Perubahan yang memutus kompatibilitas berarti path versi baru, dengan v1 dipertahankan secara paralel setidaknya selama 12 bulan dan pemberitahuan penghentian melalui email ke setiap workspace dengan kunci aktif.

Field permintaan

Field item

Kode kendaraan

Dihasilkan dari spesifikasi mesin aktif. Kendaraan khusus dari armada workspace Anda dapat digunakan melalui custom_vehicle_id.

Truk & trailer

Kontainer

Tingkat akses & batasan

Hanya pengemasan yang berhasil dihitung — validasi gagal dan pekerjaan yang gagal tidak mengurangi kuota. Kedua penghitung akan direset pada tanggal 1 (UTC). Hasil sandbox lengkap dan tidak dibatasi — batasannya adalah gerbang, bukan keluaran. Butuh lebih dari 5.000 pengemasan per bulan? Hubungi kami untuk diskusi mengenai volume dan harga OEM.

Webhook

Sertakan callback_url untuk menerima hasil via POST saat pekerjaan selesai. Setiap callback membawa X-Hansatic-Signature: HMAC-SHA256 dari body mentah dengan rahasia webhook kunci Anda (ditampilkan sekali saat pembuatan kunci). Verifikasi:

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

Pengiriman dilakukan satu kali dengan batas waktu 5s — status_url tetap menjadi sumber kebenaran.

Kesalahan

Semua kesalahan berbentuk { "error": { "code", "message", ... } } — kode yang dapat dibaca mesin, pesan yang dapat dibaca manusia, dan field jika input tertentu bermasalah.