---
title: "SDK et CLI pour l'API Printags : npm install printags | Printags"
description: "SDK et ligne de commande officiels de Printags sur npm : lister et créer des commandes de cartes, tester avec le bac à sable, sans dépendance, licence MIT."
canonical: "https://www.printags.com/fr_fr/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.

[Installer le paquet](#install)[Voir sur npm](https://www.npmjs.com/package/printags)

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

## 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.

## Ressources

* [Documentation de l'API (docs.printags.com)](https://docs.printags.com)
* [Document OpenAPI (JSON)](https://www.printags.com/openapi.json)
* [Code source sur GitHub (printags/printags-js)](https://github.com/printags/printags-js)
* [Intégration de l'API REST](https://www.printags.com/fr_fr/integration-api/)
* [Serveur MCP Printags](https://www.printags.com/fr_fr/serveur-mcp/)
* [Compétences d'agents sur GitHub (printags/agent-skills)](https://github.com/printags/agent-skills)

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.