Packing API

התחלה מהירה

1. התחברו → לחצו על השם שלכם → API → צרו מפתח.
2. שלחו משימת אריזה (זו פועלת בסנדבוקס — חינם בכל תוכנית):

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 (עם אותו כותרת אימות) עד ש-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/..."
  }
}

נקודות קצה

שדות תגובה

האובייקט result במשימה שהושלמה:

גרסאות ויציבות

החוזה מגרסה בנתיב (/api/v1/). בתוך v1, שינויים הם תוספתיים בלבד — שדות בקשה אופציונליים חדשים, שדות תגובה חדשים, קודי רכב חדשים וקודי שגיאה חדשים עשויים להופיע, ולקוחות צריכים להתעלם משדות שאינם מזהים. שדות קיימים לעולם לא משנים משמעות או סוג, ושום דבר לא מוסר. שינוי שובר משמעות פירושו נתיב גרסה חדש, כאשר v1 מתוחזק במקביל למשך לפחות 12 חודשים והודעת הוצאה משימוש תישלח בדוא״ל לכל מרחב עבודה עם מפתח פעיל.

שדות בקשה

שדות פריט

קודי רכב

נוצרו ממפרטי המנוע החי. רכבים מותאמים אישית מצי המרחב העבודה שלכם פועלים באמצעות custom_vehicle_id.

משאיות ונגררים

מכולות

רמות גישה ומגבלות

רק אריזות מוצלחות נספרות — ניסיונות כושלים בוולידציה או עבודות שנכשלו אינם מחויבים כנגד המכסה. שני המונים מתאפסים ב-1 לחודש (UTC). תוצאות הסנדבוקס מלאות וללא הגבלות — המגבלה היא השער, לא התוצאה. צריכים יותר מ-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 כאשר שדה קלט ספציפי אשם.