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 оферти.

Уебхук

Подайте callback_url, за да получите резултата чрез POST при завършване на заявката. Всеки уебхук съдържа X-Hansatic-Signature: HMAC-SHA256 на необработеното тяло с уебхук секрета на вашия ключ (показва се веднъж при създаване на ключа). Проверете го:

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

Доставката е с един опит и таймаут 5s — status_url винаги остава източник на истината.

Грешки

Всички грешки са с { "error": { "code", "message", ... } } — машиночетим код, човешки четимно съобщение и field, когато проблемът е в конкретно входно поле.