API d'optimisation de chargement

Démarrage rapide

1. Connectez-vous → cliquez sur votre nom → API → générez une clé.
2. Soumettez une tâche d'optimisation (celle-ci s'exécute en bac à sable — gratuit sur tous les plans) :

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

Interrogez le status_url (avec le même en-tête d'authentification) jusqu'à ce que status soit "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/..."
  }
}

Points de terminaison

Champs de réponse

L'objet result d'une tâche terminée :

Versionnage et stabilité

Le contrat est versionné dans le chemin (/api/v1/). Au sein de v1, les modifications sont uniquement additives — nouveaux champs optionnels dans la requête, nouveaux champs de réponse, nouveaux codes de véhicules et codes d'erreur peuvent apparaître, et les clients doivent ignorer les champs qu'ils ne reconnaissent pas. Les champs existants ne changent jamais de signification ou de type, et rien n'est supprimé. Une modification incompatible entraîne un nouveau chemin de version, avec v1 maintenu en parallèle pendant au moins 12 mois et un avis de dépréciation envoyé par e-mail à chaque espace de travail disposant d'une clé active.

Champs de la requête

Champs des articles

Codes de véhicules

Générés à partir des spécifications du moteur en temps réel. Les véhicules personnalisés de votre flotte d'espace de travail fonctionnent via custom_vehicle_id.

Camions et remorques

Conteneurs

Niveaux d'accès et limites

Seuls les chargements réussis sont comptabilisés — les échecs de validation et les tâches en erreur ne sont jamais facturés sur un quota. Les deux compteurs sont réinitialisés le 1er (UTC). Les résultats en bac à sable sont complets et non limités — les limites concernent uniquement l'accès, pas la sortie. Besoin de plus de 5 000 chargements par mois ? Contactez-nous pour discuter des tarifs volume et OEM.

Webhooks

Transmettez un callback_url pour recevoir le résultat par POST lorsque la tâche est terminée. Chaque appel inclut une X-Hansatic-Signature : un HMAC-SHA256 du corps brut avec le secret webhook de votre clé (affiché une seule fois à la création de la clé). Vérifiez-la :

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

La livraison est effectuée en une seule tentative avec un délai de 5 s — le status_url reste toujours la source de vérité.

Erreurs

Toutes les erreurs sont de forme { "error": { "code", "message", ... } } — code lisible par machine, message lisible par humain, et field lorsqu'un champ spécifique est en cause.