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.
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: "[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" });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.
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.