Yuklash API

Tez boshlash

1. Tizimga kiring → ismingizni bosing → API → kalit yarating.
2. Yuklash topshirigʻini yuboring (bu sinov muhitida ishlaydi — har bir tarif rejasida bepul):

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 manzilini soʻrov yuboring (xuddi shu autentifikatsiya sarlavhasi bilan) to status "done" holatiga kelguncha:

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

Ulanish nuqtalari

Javob maydonlari

Tugallangan topshiriqdagi result obyekti:

Versiyalash va barqarorlik

Shartnoma manzilda versiyalangan (/api/v1/). v1 doirasida oʻzgarishlar faqat qoʻshimcha tarzda amalga oshiriladi — yangi ixtiyoriy soʻrov maydonlari, yangi javob maydonlari, yangi transport vositalari kodlari va xato kodlari paydo boʻlishi mumkin, mijozlar tanimagan maydonlarni eʼtiborsiz qoldirishi kerak. Mavjud maydonlarning maʼnosi yoki turi hech qachon oʻzgartirilmaydi va hech narsa olib tashlanmaydi. Buziluvchi oʻzgarish yangi versiya manzilini anglatadi, v1 esa kamida 12 oy davomida parallel ravishda saqlanadi va faol kalitga ega har bir ish maydoniga elektron pochta orqali bekor qilish xabarnomasi yuboriladi.

Soʻrov maydonlari

Element maydonlari

Transport vositalari kodlari

Jonli mexanizm spetsifikatsiyalaridan yaratilgan. Ish maydoningizdagi maxsus transport vositalari custom_vehicle_id orqali ishlaydi.

Yuk mashinalari va tirkamalar

Konteynerlar

Kirish darajalari va cheklovlar

Faqat muvaffaqiyatli joylashtirishlar hisobga olinadi — tekshiruvdan oʻta olmagan va bajarilmagan topshiriqlar kvotaga taʼsir qilmaydi. Ikkala hisoblagich ham har oyning 1-kunida (UTC boʻyicha) qayta tiklanadi. Sinov muhitidagi natijalar toʻliq va cheklanmagan — chegaralar faqat kirish uchun, natijalar uchun emas. Oyiga 5 000 dan ortiq joylashtirish kerakmi? Hajmli va OEM narxlari boʻyicha biz bilan bogʻlaning.

Veb-xuklar

Topshiriq tugaganda natijani POST orqali olish uchun callback_url kiriting. Har bir xabar X-Hansatic-Signature bilan keladi: xom tananing HMAC-SHA256 imzosi, kalit yaratishda koʻrsatilgan veb-xuk maxfiy kaliti bilan. Uni tekshiring:

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

Yetkazib berish bitta urinish bilan amalga oshiriladi, 5s vaqt chegarasi bilan — status_url har doim haqiqiy manba boʻlib qoladi.

Xatolar

Barcha xatolar { "error": { "code", "message", ... } } shaklida — mashina oʻqiy oladigan kod, inson tushunadigan xabar va field (agar muayyan kiritish maydoni xato boʻlsa).