Zum Inhalt springen

Schnellstart

Schlüssel erstellen, eine Anfrage senden, den Plan lesen.

API-Schlüssel erstellen

Öffnen Sie in der Entwicklerkonsole API-Schlüssel und erstellen Sie einen Schlüssel. Der Schlüssel wird nur einmal angezeigt.

Bash
export CARGODUO_API_KEY="cd_live_..."

Job erstellen

Mit ?wait=60 antwortet die API mit dem fertigen Job, sofern er innerhalb von 60 s abgeschlossen ist.

curl -X POST "https://runner.cargoduo.com/v1/pack?wait=60" \
  -H "Authorization: Bearer $CARGODUO_API_KEY" \
  -H "Idempotency-Key: order-1042-v1" \
  -H "Content-Type: application/json" \
  -d '{
    "reference": "order-1042",
    "vehicles": [
      {
        "id": "trailer",
        "type": "trailer",
        "name": "13.6 m trailer",
        "length": 1360,
        "width": 245,
        "height": 270,
        "max_weight": 24000
      }
    ],
    "items": [
      {
        "id": "pallet-eu",
        "label": "Euro pallet",
        "length": 120,
        "width": 80,
        "height": 140,
        "weight": 450,
        "quantity": 18,
        "stackable": false
      },
      {
        "id": "carton-a",
        "label": "Carton A",
        "length": 60,
        "width": 40,
        "height": 40,
        "weight": 12,
        "quantity": 40,
        "rotation": "upright"
      }
    ],
    "options": {
      "packing_mode": "auto"
    }
  }'

Rechtzeitig fertig: 200, status: "succeeded", der Plan steht in result. Läuft noch: 202, weiter mit Schritt 3.

Abfragen, bis der Job endet

curl "https://runner.cargoduo.com/v1/jobs/$JOB_ID?include=result" \
  -H "Authorization: Bearer $CARGODUO_API_KEY"

Plan auslesen

FeldInhalt
result.vehicles[].placements[]Position, Größe, Ausrichtung und Ladeschritt (step) jedes Artikels
result.unplaced[]Artikel, die nicht gepasst haben, mit reason
cost.creditsWas der Job gekostet hat
pdf_urlEin Link, der das PDF des Ladeplans erzeugt

POST /v1/estimate validiert denselben Body kostenlos und nennt den Preis.

Siehe auch