Genera planos de troquel desde tu propio software

Cómo funciona

1. Obtén la lista de plantillas

   GET /api/v1/catalogue devuelve todas las plantillas activas con su código público, su nombre y los nombres de sus parámetros. Filtra con q y category; pagina con limit y cursor.

2. Lee el esquema de una plantilla

   GET /api/v1/catalogue/{code} devuelve cada parámetro con su unidad, su valor por defecto, su incremento y sus reglas de mínimo y máximo —incluidas las que dependen de otra medida—, además de las opciones, las páginas y los formatos.

3. Genera el archivo

   POST /api/v1/dielines/{code} con un formato y los parámetros. El cuerpo de la respuesta es el propio archivo; su nombre y la versión de la plantilla van en las cabeceras.

Acceso y claves

La API para desarrolladores está incluida en los planes Bench, Workshop y Line. Crea y revoca claves en Cuenta → API para desarrolladores. La clave completa se muestra una sola vez; Packdroid solo guarda su hash. Una cuenta puede tener cinco claves activas.

Envía la clave como token Bearer en cada solicitud. Mantenla en tu servidor: nunca la pongas en el código de un navegador o de una app, y revócala si queda expuesta. Usa una clave distinta para cada sistema; así puedes detener una integración sin afectar a las demás.

Ejemplo de solicitud

Obtén la lista de plantillas y luego lee los parámetros de una de ellas:

curl 'https://packdroid.com/api/v1/catalogue?limit=50' \
  --header 'Authorization: Bearer pd_live_your_secret'

curl 'https://packdroid.com/api/v1/catalogue/PD-TL02' \
  --header 'Authorization: Bearer pd_live_your_secret'

Una caja americana (FEFCO 0201) de 250 × 200 × 150 mm, en cartón de 4 mm, guardada como SVG:

curl --request POST \
  'https://packdroid.com/api/v1/dielines/FEFCO%200201' \
  --header 'Authorization: Bearer pd_live_your_secret' \
  --header 'Content-Type: application/json' \
  --output dieline.svg \
  --data '{"format":"svg","parameters":{"length":250,"width":200,"depth":150,"corrugated_thickness":4}}'

Qué recibes

El SVG y el PDF se dibujan a escala real 1:1, con las líneas de corte y de hendido en capas separadas; añade cotas o el panel de información con los campos dimensions e info. El DXF está disponible para CAD y mesas de corte.

Las plantillas de varias páginas (por ejemplo, el cartón gris y el forro de una caja forrada) se devuelven como un único PDF, un ZIP de archivos DXF o un SVG combinado o separado por páginas. Las unidades siguen a la plantilla: la mayoría de las medidas van en milímetros y algunos espesores de material, en micrómetros.

Límites

Cada archivo generado correctamente cuenta para las descargas mensuales del plan. Aparte, todos los planes tienen límites operativos que protegen el servicio; las respuestas llevan cabeceras X-RateLimit y un Retry-After en los 429.

Cada clave ejecuta como máximo dos renderizados a la vez, y un renderizado se interrumpe a los 30 segundos. Una clave que supera sus límites de forma reiterada se suspende durante 15 minutos; las solicitudes no válidas se rechazan antes de descontarse del cupo mensual.

Errores

Los errores llegan en JSON con un código estable. Los errores de validación enumeran cada problema con su ubicación, por ejemplo parameters.length, y el mínimo o el máximo que incumple.

Empieza

Elige un plan de pago y crea una clave en Cuenta → API para desarrolladores. ¿Tienes dudas sobre una integración? Escríbenos.

Ver planes Crear una clave de API Contactar