Documentación para desarrolladoresPrimeros pasos

Inicio rápido

Crea una clave, envía una solicitud y lee el plan.

Crea una clave de API

En la consola de desarrolladores, abre Claves de API y crea una clave. El secreto solo se muestra una vez.

Bash

export CARGODUO_API_KEY="cd_live_..."

Crea un trabajo

Con ?wait=60, la respuesta trae el trabajo terminado si acaba en menos de 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"
    }
  }'

const res = await fetch("https://runner.cargoduo.com/v1/pack?wait=60", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.CARGODUO_API_KEY}`,
    "Idempotency-Key": "order-1042-v1",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "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"
    }
  }),
});

const data = await res.json();
console.log(res.status, data);

import os
import requests

response = requests.post(
    "https://runner.cargoduo.com/v1/pack",
    headers={"Authorization": f"Bearer {os.environ['CARGODUO_API_KEY']}", "Idempotency-Key": "order-1042-v1"},
    params={
        "wait": 60,
    },
    json={
        "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",
        },
    },
)
print(response.status_code, response.json())

Si termina a tiempo: 200, status: "succeeded" y el plan en result. Si sigue en curso: 202; pasa al paso 3.

Consulta el estado hasta que termine

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

async function waitForJob(job) {
  while (job.status === "queued" || job.status === "running") {
    await new Promise((r) => setTimeout(r, 2000));
    const res = await fetch(`https://runner.cargoduo.com/v1/jobs/${job.id}?include=result`, {
      headers: { Authorization: `Bearer ${process.env.CARGODUO_API_KEY}` },
    });
    job = await res.json();
  }
  return job;
}

import os, time, requests

def wait_for_job(job):
    headers = {"Authorization": f"Bearer {os.environ['CARGODUO_API_KEY']}"}
    while job["status"] in ("queued", "running"):
        time.sleep(2)
        job = requests.get(f"https://runner.cargoduo.com/v1/jobs/{job['id']}", params={"include": "result"}, headers=headers).json()
    return job

Lee el plan

Campo	Contenido
`result.vehicles[].placements[]`	Posición, tamaño, orientación y `step` de carga de cada artículo
`result.unplaced[]`	Artículos que no cupieron, con un `reason`
`cost.credits`	Lo que se cobró por el trabajo
`pdf_url`	Un enlace que genera el PDF del plan de carga

POST /v1/estimate valida el mismo cuerpo y calcula su precio gratis.

Ver también

Crear un trabajo de cargaValida la solicitud, reserva de tus créditos el precio máximo posible y pone un trabajo en cola.Resultados y coordenadasDónde va cada artículo, con qué orientación y en qué orden de carga.IdempotenciaReintenta POST /v1/pack sin crear un segundo trabajo.