---
title: "SDK e CLI per l'API Printags: npm install printags | Printags"
description: "SDK e riga di comando ufficiali di Printags su npm: elencare e creare ordini di carte, testare con la sandbox, senza dipendenze, licenza MIT."
canonical: "https://www.printags.com/it/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.

[Installa il pacchetto](#install)[Vedi su npm](https://www.npmjs.com/package/printags)

## 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: "jean@example.com",
    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.

## Risorse

* [Documentazione dell'API (docs.printags.com)](https://docs.printags.com)
* [Documento OpenAPI (JSON)](https://www.printags.com/openapi.json)
* [Codice sorgente su GitHub (printags/printags-js)](https://github.com/printags/printags-js)
* [Integrazione dell'API REST](https://www.printags.com/it/integrazione-api/)
* [Server MCP di Printags](https://www.printags.com/it/server-mcp/)
* [Skill per agenti su GitHub (printags/agent-skills)](https://github.com/printags/agent-skills)

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.