Packing API

Mwanzo wa haraka

1. Ingia → bonyeza jina lako → API → unda ufunguo.
2. Tuma kazi ya kupakia (hii inatekelezwa kwenye sandbox — bure kwenye kila mpango):

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

Chunguza status_url (na kibali cha uthibitisho sawa) hadi status iwe "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/..."
  }
}

Njia za API

Sehemu za majibu

Kipengele cha result kwenye kazi iliyomalizika:

Toleo na utulivu

Mkataba unaotolewa kwa njia ya /api/v1/. Ndani ya v1, mabadiliko ni ya kuongeza tu — sehemu mpya za ombi za hiari, sehemu mpya za majibu, nambari mpya za gari na nambari za makosa zinaweza kuonekana, na wateja wanapaswa kuzitilia mbali sehemu ambazo hawajui. Sehemu zilizopo kamwe hazibadilishi maana au aina, wala hakuna chochote kinachofutwa. Mabadiliko makubwa yanamaanisha njia mpya ya toleo, na v1 itatunzwa sambamba kwa angalau miezi 12 na taarifa ya kuondoa kwa barua pepe kwa kila eneo la kazi lenye ufunguo wa kazi.

Sehemu za ombi

Sehemu za kitu

Nambari za gari

Zimetengenezwa kutoka kwa taarifa za injini hai. Gari maalum kutoka kwa usafiri wako wa eneo la kazi hufanya kazi kupitia custom_vehicle_id.

Malori & viburudisho

Kontena

Viwango vya upatikanaji & vikomo

Hesabu inahusu tu pakiti zilizofanikiwa — zile zisizokidhi vigezo na kazi zilizoshindwa hazihusiki na kipimo. Vijenzi vyote hupangwa upya tarehe 1 (UTC). Matokeo ya sandbox ni kamili na yasiyopunguzwa — vikwazo ndivyo kizingiti, si matokeo. Unahitaji zaidi ya pakiti 5,000 kwa mwezi? Wasiliana nasi kuhusu bei ya wingi na OEM.

Webhooks

Tuma callback_url ili upokee matokeo kupitia POST wakati kazi inapomalizika. Kila callback inabeba X-Hansatic-Signature: HMAC-SHA256 ya mwili wa maandishi kwa siri yako ya webhook ya ufunguo (inayoonekana mara moja wakati wa kuunda ufunguo). Thibitisha:

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

Uwasilishaji ni jaribio moja na muda wa muda wa 5s — status_url daima inabaki chanzo cha ukweli.

Makosa

Makosa yote ni { "error": { "code", "message", ... } } — nambari ya makosa inayosomwa na mashine, ujumbe unaosomwa na binadamu, na field wakati sehemu maalum ya ombi ni sababu.