Packnings-API

Kom igång snabbt

1. Logga in → klicka på ditt namn → API → generera en nyckel.
2. Skicka en packningsuppgift (den här körs i sandbox — gratis på alla plan):

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

Poll:a status_url (samma autentiseringsheader) tills status är "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/..."
  }
}

Slutpunkter

Svarsfält

result-objektet för en avslutad uppgift:

Versionshantering och stabilitet

Kontraktet är versionshanterat i sökvägen (/api/v1/). Inom v1 är ändringar endast tillägg — nya valfria fält i förfrågan, nya svarsfält, nya fordonskoder och felkoder kan tillkomma, och klienter bör ignorera fält de inte känner igen. Befintliga fält ändrar aldrig betydelse eller typ, och inget tas bort. En brytande ändring innebär en ny versionssökväg, med v1 som underhålls parallellt i minst 12 månader och avvecklingsmeddelande via e-post till varje workspace med en aktiv nyckel.

Förfrågningsfält

Artikelfält

Fordonskoder

Genererade från den aktiva motorns specifikationer. Anpassade fordon från din workspace-flotta fungerar via custom_vehicle_id.

Lastbilar och släp

Containrar

Åtkomstnivåer och gränser

Endast lyckade packningar räknas — misslyckad validering och misslyckade jobb debiteras aldrig mot kvoten. Båda räknarna nollställs den 1:a (UTC). Sandbox-resultat är fullständiga och utan begränsningar — gränserna gäller åtkomst, inte resultat. Behöver du mer än 5 000 packningar per månad? Kontakta oss för volym- och OEM-priser.

Webhooks

Ange callback_url för att ta emot resultatet via POST när uppgiften är klar. Varje callback innehåller X-Hansatic-Signature: en HMAC-SHA256 av den råa brödtexten med din nyckels webhook-hemlighet (visas en gång vid nyckelgenerering). Verifiera den:

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

Leverans sker i ett försök med 5s timeout — status_url är alltid den giltiga källan.

Fel

Alla fel har { "error": { "code", "message", ... } } — maskinläsbar kod, läsbar beskrivning och field när ett specifikt inmatningsfält är felaktigt.