Llame a PiQ. Reciba un dibujo.
Una API para sistemas de diseño, estimación y producción que necesitan dibujos paramétricos bajo demanda.
El motor paramétrico de ParametrIQ, como servicio web
PiQ SaaS ejecuta dibujos de ParametrIQ para su propio software. Envíe una plantilla (un dibujo de ParametrIQ, con sus medidas como variables etiquetadas) y los valores que desee, y reciba el dibujo: completo, exportado al archivo que necesita su impresora, troquelista o mesa de corte, o calculado en cifras para un presupuesto. Es el mismo motor que hace funcionar ParametrIQ CAD, por lo que una plantilla dibujada y probada allí funciona aquí exactamente igual.
Una solicitud, un dibujo
Cada solicitud es una plantilla y sus valores, en JSON por HTTPS, con su clave de API en un encabezado. Solo se pueden dar valores a las variables etiquetadas de la plantilla, y cada valor se comprueba: una longitud que no es un número, una opción que no está entre las de la plantilla o un valor para una variable que la plantilla no pide se rechaza, indicando cuál y por qué. No se conserva nada entre solicitudes, por lo que la misma solicitud genera siempre el mismo dibujo.
- Web-to-print y configuradores: un cliente escribe sus medidas y obtiene una prueba y un precio.
- Estimación: longitud de fleje por tipo, área de la plancha, aprovechamiento del pliego y coste del troquel, antes de dibujar nada a mano.
- Producción: el archivo de corte escrito directamente en su flujo de trabajo, en el formato que espera cada máquina.
POST /export/pdf
X-API-KEY: your-api-key
Content-Type: application/json
{
"source": { "storage": "main", "key": "templates/rsc.piq" },
"values": { "L": 500, "W": 320, "D": 250,
"T": "C flute (4 mm)" }
}Una caja FEFCO 0201, 500 × 320 × 250, en canal C: se recibe el PDF.
Lo que devuelve
Archivos
PDF, SVG, EPS y Adobe Illustrator con las capas de líneas de troquel como colores directos, y un PDF de plano de troquel listo para impresión; imágenes PNG, JPEG y WebP; G-code, HP-GL y GP-GL para mesas de corte y plóteres; CF2 y DDES3 para troquelistas; LightBurn y SVG para láseres, Cricut y Silhouette; PDF y EPS de impresión y corte; DSTV NC e IFC para acero; DXF con datos de doblez y STEP para chapa metálica; DXF AAMA/ASTM para patrones; PDF en mosaico, para proyector y de plantillas envolventes; DXF y HP-GL para cortadoras de paspartú; DXF para otros programas de CAD.
Mediciones
La extensión del dibujo, sus longitudes de corte y de hendido por capa, y las planchas que corta, con su área y su perímetro. O cualquier expresión calculada en el dibujo: AREAOF(@1), DISTANCE(P1,P4), la tolerancia de un material.
El troquel y su coste
El troquel de fleje que necesita el dibujo, tal como lo calcula Crear troquel de ParametrIQ CAD: el fleje por tipo, puentes, muescas, agujeros, la plancha y cuánto de ella ocupan las planchas desarrolladas, y una estimación de su coste según sus propios precios.
Lo que pide una plantilla
Las variables etiquetadas de una plantilla, cada una con su etiqueta, el tipo de valor que admite y, si es una opción, lo que se puede elegir: suficiente para crear un formulario para cualquier plantilla sin escribirlo a mano.
El propio dibujo
El dibujo completo como texto de dibujo de ParametrIQ, todavía paramétrico, con los valores indicados: ábralo en ParametrIQ CAD para terminarlo a mano o consérvelo como registro del trabajo.
Una vista previa rápida
Un PNG del dibujo, de 16 a 4000 píxeles de ancho: una imagen de lo que generan las medidas del cliente, para un configurador, un presupuesto o una confirmación de pedido.
Plegado en 3D
El dibujo plegado tal como lo pliega la vista 3D de ParametrIQ: mallas listas para dibujar con WebGL, three.js o un motor de juegos, en pasos desde plano hasta plegado, con el aspecto de su material o de cualquiera de los aspectos integrados (cartón ondulado, cartoncillo, cartón rígido, metales, plásticos, tejidos, madera).
Sus plantillas y archivos, en su propio almacenamiento
Registre una vez su propio almacenamiento compatible con S3 (AWS S3, Cloudflare R2, Backblaze B2, Wasabi, MinIO, DigitalOcean Spaces …) con el nombre que elija. Después guarde allí sus plantillas y nombre una en la solicitud en lugar de enviarla, y haga que los archivos exportados se guarden directamente en él en lugar de descargarse: la prueba en la carpeta del cliente, el archivo de corte en la de la máquina.
- Se prueba antes de guardarlo: un almacenamiento al que no se puede acceder, o que rechaza sus claves, no se registra, y se le indica el motivo.
- Limitado a su carpeta: indique un prefijo y las claves no podrán acceder por encima de él.
- Secretos que se mantienen en secreto: la clave secreta se almacena cifrada y nunca se devuelve.
- Solo suyo: cada suscripción accede únicamente a los almacenamientos que ha registrado.
PUT /storages/main
{
"serviceUrl": "https://ACCOUNT.r2.cloudflarestorage.com",
"region": "auto",
"bucket": "my-bucket",
"prefix": "piq/",
"accessKeyId": "…",
"secretAccessKey": "…"
}
POST /save/pdf
{
"source": { "storage": "main", "key": "templates/rsc.piq" },
"values": { "L": 500 },
"destination": { "storage": "main", "key": "proofs/" }
}Llámela desde cualquier sistema
La API se describe mediante un documento OpenAPI, de modo que se puede generar un cliente en la mayoría de los lenguajes con Kiota, NSwag u OpenAPI Generator. O parta de uno de nuestros ejemplos: cada uno enumera las entradas de una plantilla, la mide, exporta un PDF y muestra qué hacer cuando se rechaza una solicitud.
Respuestas claras cuando no puede
Una solicitud que no se puede llevar a cabo recibe como respuesta una descripción de problema estándar: qué está mal, indicando el valor al que se refiere. No se adivina nada.
Límites que le protegen
Cada plantilla dispone de un tiempo de ejecución fijo, de modo que un error en ella (un bucle que no termina nunca) se detiene y se notifica en lugar de quedarse en ejecución. Las solicitudes que superan lo que el servicio puede ejecutar a la vez esperan su turno y, si hay demasiadas en espera, se rechazan (429) para que se vuelvan a intentar.
Dibujadas en ParametrIQ CAD
Las plantillas son dibujos normales de ParametrIQ: dibuje y pruebe una en ParametrIQ CAD con Ejecutar paramétrico, etiquete las medidas que pide y estará lista para la API.
Obtenga PiQ SaaS
Suscríbase, copie su clave de API desde Cuenta › Licencias y envíe su primera solicitud.