Paketleme API

Hızlı başlangıç

1. Oturum açın → adınıza tıklayın → API → bir anahtar oluşturun.
2. Bir paketleme işi gönderin (bu örnek sandbox'ta çalışır — her planda ücretsizdir):

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 adresini sorgulayın (aynı kimlik doğrulama başlığıyla) ta ki status "done" olana kadar:

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

Uç noktalar

Yanıt alanları

Tamamlanmış bir işteki result nesnesi:

Sürüm yönetimi ve kararlılık

Sözleşme, yolda (/api/v1/) sürümlendirilir. v1 içinde yapılan değişiklikler yalnızca eklemelidir — yeni isteğe bağlı alanlar, yeni yanıt alanları, yeni araç kodları ve hata kodları eklenebilir. İstemciler tanımadıkları alanları görmezden gelmelidir. Mevcut alanların anlamı veya türü asla değişmez ve hiçbir şey kaldırılmaz. Kırılım değişikliği, yeni bir sürüm yolu anlamına gelir; v1 en az 12 ay boyunca paralel olarak sürdürülür ve aktif anahtarı olan her çalışma alanına e-posta ile kullanımdan kaldırma bildirimi gönderilir.

İstek alanları

Öğe alanları

Araç kodları

Canlı motor özelliklerinden oluşturulmuştur. Çalışma alanınızdaki özel araçlar custom_vehicle_id ile çalışır.

Kamyonlar ve römorklar

Konteynerler

Erişim seviyeleri ve sınırlar

Yalnızca başarılı paketlemeler kota hesabına dahil edilir — geçersiz doğrulama ve başarısız işler kotayı etkilemez. Her iki sayaç da ayın 1'inde (UTC) sıfırlanır. Sandbox sonuçları eksiksiz ve sınırsızdır — sınırlar yalnızca giriş kriteridir, çıktıyı etkilemez. Ayda 5.000'den fazla paketlemeye mi ihtiyacınız var? Toplu ve OEM fiyatlandırması için bizimle iletişime geçin.

Webhook'lar

İş tamamlandığında sonucu POST ile almak için callback_url gönderin. Her geri çağırma, X-Hansatic-Signature içerir: ham gövdenin HMAC-SHA256 imzası, anahtarınızın webhook gizli anahtarıyla (anahtar oluşturulurken bir kez gösterilir). Doğrulayın:

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

Teslimat tek deneme ile 5s zaman aşımına sahiptir — status_url her zaman gerçek kaynaktır.

Hatalar

Tüm hatalar { "error": { "code", "message", ... } } şeklindedir — makine tarafından okunabilir kod, insan tarafından okunabilir mesaj ve hatalı bir giriş olduğunda field.