SDK y CLI
SDK y CLI de Printags para la API
Llame a la API de Printags desde Node.js o desde la línea de comandos. Un solo paquete npm, sin dependencias.
Instalación
Node.js 18 o superior. El paquete contiene el SDK y el comando printags.
npm install printags
SDK para Node.js
Cada método corresponde a una operación del documento OpenAPI, con el nombre de la propia operación. Los errores son objetos PrintagsError con el estado HTTP y el código de error de la API.
import { Printags } from "printags";
const printags = new Printags({ apiKey: process.env.PRINTAGS_API_KEY });
const { orders } = await printags.listOrders("@me", { perPage: 10 });
// A draft prints and charges nothing until it is validated.
// The idempotency key makes a retry safe: the same key returns the order already created.
const { orderId } = await printags.createOrder("@me", {
isDraft: true,
reference: "Order-2026-001",
shipTo: { name: "Jean Dupont", phone: "+33612345678", email: "[email protected]",
address: { addressLine1: "12 rue de la Paix", city: "Paris", postcode: "75002", countryCode: "FR" } },
items: [{ productId: "ntag213_pvccard_white", quantity: 10, printingVisuals: [fileId],
nfc: { type: "uri", content: "https://example.com/jean" } }]
}, { idempotencyKey: "order-2026-001" });Línea de comandos
Las mismas operaciones desde un terminal o un script. La salida es JSON.
export PRINTAGS_API_KEY=sk_test_... export PRINTAGS_SANDBOX=1 npx printags statuses npx printags carriers --to-country FR npx printags orders list --per-page 5 npx printags orders create --file order.json --idempotency-key order-2026-001
Sandbox
Una clave de prueba (sk_test_...) crea pedidos de prueba que no se cobran ni se fabrican. Con la opción sandbox, el SDK y la CLI usan sandbox-api.printags.com, que solo acepta claves de prueba: una clave real se rechaza antes de que ninguna solicitud salga de su equipo.
Preguntas
SDK y CLI: sus preguntas
¿Existe un SDK oficial de Printags?
Sí: el paquete npm printags, para Node.js 18 o superior, sin dependencias. La API es una API REST estándar descrita por un documento OpenAPI, así que cualquier lenguaje puede llamarla.
¿Puedo probar el SDK sin pedir tarjetas reales?
Sí. Use una clave de prueba (sk_test_...) con la opción sandbox: los pedidos creados son pedidos de prueba, que no se cobran ni se fabrican.
¿Con qué licencia se publica el paquete?
MIT. El código fuente está en GitHub: printags/printags-js.