SDK e CLI
SDK e CLI Printags per l'API
Chiamate l'API Printags da Node.js o dalla riga di comando. Un solo pacchetto npm, senza dipendenze.
Installazione
Node.js 18 o superiore. Il pacchetto contiene l'SDK e il comando printags.
npm install printags
SDK per Node.js
Ogni metodo corrisponde a un'operazione del documento OpenAPI, con il nome stesso dell'operazione. Gli errori sono oggetti PrintagsError con lo stato HTTP e il codice di errore dell'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" });Riga di comando
Le stesse operazioni da un terminale o da uno script. L'output è 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 chiave di test (sk_test_...) crea ordini di prova che non vengono addebitati né fabbricati. Con l'opzione sandbox, l'SDK e la CLI usano sandbox-api.printags.com, che accetta solo chiavi di test: una chiave reale viene rifiutata prima che qualsiasi richiesta lasci la vostra macchina.
Domande
SDK e CLI: le vostre domande
Esiste un SDK ufficiale di Printags?
Sì: il pacchetto npm printags, per Node.js 18 o superiore, senza dipendenze. L'API è una normale API REST descritta da un documento OpenAPI, quindi qualsiasi linguaggio può chiamarla.
Posso provare l'SDK senza ordinare carte vere?
Sì. Usate una chiave di test (sk_test_...) con l'opzione sandbox: gli ordini creati sono ordini di prova, non addebitati né fabbricati.
Con quale licenza è pubblicato il pacchetto?
MIT. Il codice sorgente è su GitHub: printags/printags-js.