Packing API

Snel starten

1. Log in → klik op je naam → API → genereer een sleutel.
2. Dien een pack-taak in (deze wordt in de sandbox uitgevoerd — gratis op elk abonnement):

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 de status_url (zelfde auth-header) totdat status "done" is:

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

Eindpunten

Antwoordvelden

Het result-object bij een voltooide taak:

Versiebeheer en stabiliteit

Het contract is versiebeheerd in het pad (/api/v1/). Binnen v1 zijn wijzigingen alleen additief — nieuwe optionele aanvraagvelden, nieuwe antwoordvelden, nieuwe voertuigcodes en foutcodes kunnen verschijnen, en clients moeten velden negeren die ze niet herkennen. Bestaande velden veranderen nooit van betekenis of type, en niets wordt verwijderd. Een breaking change betekent een nieuw versiepad, waarbij v1 minimaal 12 maanden parallel wordt onderhouden en er een deprecation-melding per e-mail wordt verzonden naar elke werkruimte met een actieve sleutel.

Aanvraagvelden

Itemvelden

Voertuigcodes

Gegenereerd vanuit de live-engine-specificaties. Aangepaste voertuigen uit je werkruimte-vloot werken via custom_vehicle_id.

Vrachtwagens & opleggers

Containers

Toegangsniveaus en limieten

Alleen succesvolle pakketten tellen mee — mislukte validaties en mislukte taken worden niet in rekening gebracht voor een quotum. Beide tellers worden op de 1e (UTC) gereset. Sandbox-resultaten zijn volledig en onbeperkt — de limieten zijn de drempel, niet de uitkomst. Meer dan 5.000 pakketten per maand nodig? Neem contact met ons op voor volumekorting en OEM-prijzen.

Webhooks

Geef callback_url op om het resultaat via POST te ontvangen wanneer de taak is voltooid. Elke callback bevat een X-Hansatic-Signature: een HMAC-SHA256 van de onbewerkte body met het webhook-geheim van je sleutel (eenmalig getoond bij het aanmaken van de sleutel). Verifieer deze:

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

Levering gebeurt in één poging met een time-out van 5s — de status_url blijft altijd de bron van waarheid.

Fouten

Alle fouten hebben de vorm { "error": { "code", "message", ... } } — een machineleesbare code, een menselijk leesbaar bericht en field als een specifiek invoerveld de fout veroorzaakt.