Packing API

เริ่มต้นใช้งานอย่างรวดเร็ว

1. เข้าสู่ระบบ → คลิกที่ชื่อของคุณ → API → สร้างคีย์
2. ส่งงานบรรทุก (ตัวอย่างนี้ทำงานใน Sandbox — ฟรีในทุกแผน):

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

ตรวจสอบสถานะที่ status_url (ใช้ Header การยืนยันตัวตนเดียวกัน) จนกว่า status จะเป็น "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/..."
  }
}

Endpoints

ฟิลด์การตอบกลับ

ออบเจกต์ result เมื่องานเสร็จสมบูรณ์:

การกำหนดเวอร์ชันและความเสถียร

สัญญาจะถูกกำหนดเวอร์ชันในพาธ (/api/v1/) ภายใน v1 การเปลี่ยนแปลงจะเป็นการเพิ่มเติมเท่านั้น — ฟิลด์คำขอใหม่ที่ไม่บังคับ ฟิลด์การตอบกลับใหม่ รหัสยานพาหนะใหม่ และรหัสข้อผิดพลาดใหม่ อาจปรากฏขึ้น และไคลเอนต์ควรละเว้นฟิลด์ที่ไม่รู้จัก ความหมายและประเภทของฟิลด์ที่มีอยู่จะไม่มีการเปลี่ยนแปลง และจะไม่มีการลบฟิลด์ใด ๆ การเปลี่ยนแปลงที่ส่งผลกระทบจะหมายถึงพาธเวอร์ชันใหม่ โดย v1 จะยังคงได้รับการดูแลควบคู่กันไปอย่างน้อย 12 เดือน และจะมีการแจ้งเตือนการเลิกใช้งานทางอีเมลไปยังพื้นที่ทำงานทุกแห่งที่มีคีย์ใช้งานอยู่

ฟิลด์คำขอ

ฟิลด์สินค้า

รหัสยานพาหนะ

สร้างจากข้อมูลจำเพาะของเครื่องมือจริง ยานพาหนะที่กำหนดเองจากฝูงรถในพื้นที่ทำงานของคุณสามารถใช้งานได้ผ่าน custom_vehicle_id

รถบรรทุกและรถพ่วง

คอนเทนเนอร์

ระดับการเข้าถึงและขีดจำกัด

นับเฉพาะแพ็กที่สำเร็จเท่านั้น — การตรวจสอบความถูกต้องที่ล้มเหลวและงานที่ล้มเหลวจะไม่ถูกนับเป็นโควต้า ทั้งสองตัวนับจะรีเซ็ตในวันที่ 1 (UTC) ผลลัพธ์ใน Sandbox มีความสมบูรณ์และไม่ถูกจำกัด — ขีดจำกัดเป็นเพียงเกณฑ์ ไม่ใช่ผลลัพธ์ ต้องการมากกว่า 5,000 แพ็กต่อเดือนหรือไม่? ติดต่อเราเพื่อหารือเกี่ยวกับราคาสำหรับปริมาณมากและ OEM

Webhooks

ส่ง callback_url เพื่อรับผลลัพธ์ผ่าน POST เมื่องานเสร็จสมบูรณ์ ทุกการเรียกกลับจะมี X-Hansatic-Signature: HMAC-SHA256 ของเนื้อหาดิบด้วยคีย์ลับของ Webhook ของคุณ (แสดงครั้งเดียวเมื่อสร้างคีย์) ตรวจสอบลายเซ็นดังนี้:

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

การส่งจะพยายามเพียงครั้งเดียวด้วยระยะเวลาหมดเวลา 5 วินาที — status_url ยังคงเป็นแหล่งข้อมูลที่ถูกต้องเสมอ

ข้อผิดพลาด

ข้อผิดพลาดทั้งหมดมีรูปแบบ { "error": { "code", "message", ... } } — รหัสที่อ่านได้ด้วยเครื่อง ข้อความที่มนุษย์อ่านได้ และ field เมื่อฟิลด์ข้อมูลที่ระบุมีปัญหา