Перейти к содержимому
CargoDuo logoCargoDuo
Цены

Быстрый старт

Создайте ключ, отправьте запрос, прочитайте план.

Создайте API-ключ

В консоли разработчика откройте API keys и создайте ключ. Секрет показывается один раз.

Bash
export CARGODUO_API_KEY="cd_live_..."

Создайте задание

С ?wait=60 ответ придёт с готовым заданием, если оно завершится за 60 s.

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

Успело завершиться: 200, status: "succeeded", план в result. Ещё выполняется: 202, переходите к шагу 3.

Опрашивайте до завершения

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

Прочитайте план

ПолеСодержимое
result.vehicles[].placements[]Положение, размер, ориентация и шаг загрузки step для каждой единицы груза
result.unplaced[]Единицы, которые не поместились, с причиной reason
cost.creditsСколько списано за задание
pdf_urlСсылка, по которой формируется PDF с планом загрузки

POST /v1/estimate бесплатно проверяет и оценивает то же тело запроса.

См. также