SDK et CLI
SDK et CLI Printags pour l'API
Appelez l'API Printags depuis Node.js ou en ligne de commande. Un seul paquet npm, sans dépendance.
Installation
Node.js 18 ou supérieur. Le paquet contient le SDK et la commande printags.
npm install printags
SDK pour Node.js
Chaque méthode correspond à une opération du document OpenAPI, sous le nom même de l'opération. Les erreurs sont des objets PrintagsError avec le statut HTTP et le code d'erreur de l'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" });Ligne de commande
Les mêmes opérations depuis un terminal ou un script. La sortie est en 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
Bac à sable
Une clé de test (sk_test_...) crée des commandes de test, ni débitées ni fabriquées. Avec l'option bac à sable, le SDK et le CLI utilisent sandbox-api.printags.com, qui n'accepte que des clés de test : une clé réelle est refusée avant qu'aucune requête ne quitte votre machine.
Questions
SDK et CLI : vos questions
Existe-t-il un SDK officiel Printags ?
Oui : le paquet npm printags, pour Node.js 18 ou supérieur, sans dépendance. L'API est une API REST classique décrite par un document OpenAPI : n'importe quel langage peut l'appeler.
Puis-je essayer le SDK sans commander de vraies cartes ?
Oui. Utilisez une clé de test (sk_test_...) avec l'option bac à sable : les commandes créées sont des commandes de test, ni débitées ni fabriquées.
Sous quelle licence le paquet est-il publié ?
MIT. Le code source est sur GitHub : printags/printags-js.