Packing API

Γρήγορη εκκίνηση

1. Συνδεθείτε → κάντε κλικ στο όνομά σας → API → δημιουργήστε ένα κλειδί.
2. Υποβάλετε μια εργασία συσκευασίας (αυτή εκτελείται σε sandbox — δωρεάν σε κάθε πρόγραμμα):

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 μήνες και ειδοποίηση κατάργησης μέσω email σε κάθε χώρο εργασίας με ενεργό κλειδί.

Πεδία αιτήματος

Πεδία αντικειμένου

Κωδικοί οχημάτων

Δημιουργούνται από τις προδιαγραφές του ενεργού μηχανισμού. Τα προσαρμοσμένα οχήματα από τον στόλο του χώρου εργασίας σας λειτουργούν μέσω custom_vehicle_id.

Φορτηγά & ρυμουλκούμενα

Κοντέινερ

Επίπεδα πρόσβασης & όρια

Μετράνε μόνο οι επιτυχημένες συσκευασίες — οι αποτυχημένες επικυρώσεις και οι αποτυχημένες εργασίες δεν χρεώνονται στο όριο. Οι μετρητές επαναρυθμίζονται την 1η ημέρα του μήνα (UTC). Τα αποτελέσματα του sandbox είναι πλήρη και χωρίς περιορισμούς — το όριο αφορά την πρόσβαση, όχι την έξοδο. Χρειάζεστε περισσότερες από 5.000 συσκευασίες τον μήνα; Επικοινωνήστε μαζί μας για προσφορές όγκου και OEM τιμές.

Webhooks

Περάστε callback_url για να λάβετε το αποτέλεσμα μέσω POST όταν ολοκληρωθεί η εργασία. Κάθε κλήση περιλαμβάνει X-Hansatic-Signature: ένα HMAC-SHA256 του ακατέργαστου σώματος με το μυστικό κλειδί webhook σας (εμφανίζεται μία φορά κατά τη δημιουργία του κλειδιού). Επικυρώστε το:

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 όταν ένα συγκεκριμένο πεδίο εισόδου είναι εσφαλμένο.