---
title: "SDK und CLI für die Printags API: npm install printags | Printags"
description: "Offizielles Printags-SDK und Kommandozeile auf npm: Kartenbestellungen auflisten und anlegen, mit der Sandbox testen, ohne Abhängigkeiten, MIT-Lizenz."
canonical: "https://www.printags.com/de/sdk-und-cli/"
---

# Printags SDK und CLI für die API

Rufen Sie die Printags API aus Node.js oder von der Kommandozeile auf. Ein einziges npm-Paket, ohne Abhängigkeiten.

[Paket installieren](#install)[Auf npm ansehen](https://www.npmjs.com/package/printags)

## Installation

Node.js 18 oder neuer. Das Paket enthält das SDK und den Befehl printags.

npm install printags

## SDK für Node.js

Jede Methode entspricht einer Operation des OpenAPI-Dokuments, unter dem Namen der Operation. Fehler sind PrintagsError-Objekte mit dem HTTP-Status und dem Fehlercode der 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" });

## Kommandozeile

Dieselben Operationen im Terminal oder in einem Skript. Die Ausgabe ist 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

Ein Testschlüssel (sk\_test\_...) erzeugt Testbestellungen, die weder berechnet noch gefertigt werden. Mit der Sandbox-Option verwenden SDK und CLI sandbox-api.printags.com, das nur Testschlüssel akzeptiert: Ein echter Schlüssel wird abgelehnt, bevor eine Anfrage Ihren Rechner verlässt.

## Ressourcen

* [API-Dokumentation (docs.printags.com)](https://docs.printags.com)
* [OpenAPI-Dokument (JSON)](https://www.printags.com/openapi.json)
* [Quellcode auf GitHub (printags/printags-js)](https://github.com/printags/printags-js)
* [Integration der REST-API](https://www.printags.com/de/api-integration/)
* [Printags MCP-Server](https://www.printags.com/de/mcp-server/)
* [Agent-Skills auf GitHub (printags/agent-skills)](https://github.com/printags/agent-skills)

Fragen

## SDK und CLI: Ihre Fragen

### Gibt es ein offizielles Printags-SDK?

Ja: das npm-Paket printags, für Node.js 18 oder neuer, ohne Abhängigkeiten. Die API ist eine Standard-REST-API, die ein OpenAPI-Dokument beschreibt, jede Sprache kann sie also aufrufen.

### Kann ich das SDK testen, ohne echte Karten zu bestellen?

Ja. Verwenden Sie einen Testschlüssel (sk\_test\_...) mit der Sandbox-Option: Die angelegten Bestellungen sind Testbestellungen, weder berechnet noch gefertigt.

### Unter welcher Lizenz wird das Paket veröffentlicht?

MIT. Der Quellcode liegt auf GitHub: printags/printags-js.