--- title: "API Printags : documentation REST, OpenAPI, SDK et CLI | Printags" description: "API REST Printags (OpenAPI) : créez et suivez des commandes de cartes PVC et NFC, testez avec des clés de bac à sable, utilisez le SDK et le CLI npm ou le serveur MCP." canonical: "https://www.printags.com/fr_fr/integration-api/" --- # Intégration API Automatisez la production de cartes depuis votre système. REST API, webhooks, documentation complète. [Accéder à la documentation](https://docs.printags.com)[Parler à un ingénieur](https://app.monagence.pro/book/printags/decouvrir-printags) Intégration rapide ## Simple à intégrer Une requête HTTP suffit pour déclencher l'impression, l'encodage NFC et l'expédition d'une carte. Webhooks pour le suivi en temps réel. * REST API avec authentification par clé API * Webhooks pour les mises à jour de statut en temps réel * Sandbox complète pour tester sans frais * Documentation OpenAPI (Swagger) complète * Réponses JSON standardisées et paginées * Idempotence sur les requêtes de création Les mêmes opérations se pilotent aussi depuis un assistant IA. [Découvrir le serveur MCP Printags](https://www.printags.com/fr_fr/serveur-mcp/) [SDK et CLI Printags pour l'API](https://www.printags.com/fr_fr/sdk-et-cli/) // Créer une commande de carte POST https://api.printags.com/v2/accounts/@me/orders Authorization: Bearer sk_test_... Idempotency-Key: order-2026-001 { "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": [""], "nfc": { "type": "uri", "content": "https://example.com/jean" } }] } Architecture ## Architecture d'intégration Votre système communique avec l'API Printags. Nous gérons tout le reste. Votre système ERP, CRM, e-commerce, SaaS API RESTWebhooks Printags Impression + encodage + expédition Référence API ## Endpoints principaux POST`/v2/accounts/{accountId}/orders`Créer une commande, en brouillon ou ferme (en-tête Idempotency-Key accepté) GET`/v2/accounts/{accountId}/orders/{orderId}`Lire une commande GET`/v2/accounts/{accountId}/orders`Lister les commandes, avec pagination POST`/v2/accounts/{accountId}/files`Déposer un fichier de visuel GET`/v2/products`Catalogue des produits POST`/v2/shipping/rates`Prix de livraison pour une destination POST`/v2/accounts/{accountId}/orders/{orderId}/validate`Valider une commande en brouillon GET`/v2/statuses`Statuts des commandes Webhooks ## Notifications en temps réel Recevez des notifications automatiques quand une commande change. Configurez vos webhooks depuis le tableau de bord. `order.created` Commande créée `order.updated` Commande mise à jour `order.shipped` Commande expédiée `order.delivered` Livraison confirmée Sandbox & sécurité ## Testez en toute sécurité Les clés de test (sk\_test\_...) créent des commandes de test, ni débitées ni fabriquées. Utilisez l'API de production avec une clé de test, ou sandbox-api.printags.com, qui n'accepte que des clés de test. * Les commandes de test ne sont jamais débitées ni fabriquées * Clés API séparées (test / production) * HTTPS obligatoire sur tous les endpoints * Limites de débit annoncées dans les en-têtes standard RateLimit * Logs et historique de toutes les requêtes Scénarios d'intégration ## Comment nos intégrateurs utilisent l'API ### E-commerce Un client commande une carte sur votre boutique. L'API déclenche automatiquement la production et l'expédition. ### SaaS / Plateforme Votre plateforme gère des membres. À chaque inscription, une carte est automatiquement imprimée et envoyée. ### RH / Corporate Nouvel employé = badge automatique. L'API s'intègre à votre SIRH pour déclencher la production. ### IoT / Bornes Nouvel abonné à votre réseau de bornes = badge NFC imprimé et expédié automatiquement via l'API. ### Événementiel Inscriptions en ligne = badges personnalisés produits et envoyés aux participants avant l'événement. ### Programme fidélité Nouveau membre de votre programme = carte fidélité NFC imprimée avec données variables et encodage. Votre boutique tourne sur WooCommerce, Shopify ou PrestaShop ? Pas besoin de développer. [L'extension WooCommerce, l'app Shopify et le module PrestaShop](https://www.printags.com/fr_fr/integrations/) Questions fréquentes ## FAQ — Intégration API ### Combien de temps prend l'intégration ? La plupart de nos intégrateurs sont opérationnels en moins d'une journée. La documentation est complète, avec des exemples de code dans plusieurs langages. Un environnement sandbox est disponible immédiatement. ### Des SDK sont-ils disponibles ? Oui : le paquet npm printags (SDK et ligne de commande pour Node.js 18 ou supérieur, licence MIT). L'API est aussi une API REST classique décrite par un document OpenAPI : n'importe quel langage peut l'appeler. Voir la page SDK et CLI. ### L'API est-elle disponible 24/7 ? Oui, l'API est disponible 24h/24, 7j/7\. Nous garantissons un SLA de 99,9% de disponibilité. Un statut en temps réel est disponible sur notre page de statut. ### Comment fonctionne la facturation ? Abonnement mensuel + coût unitaire par carte, facturés automatiquement en fin de mois. ### Les données transmises sont-elles sécurisées ? Oui. HTTPS obligatoire sur tous les endpoints. Les données personnelles (photos, noms) sont chiffrées au repos et supprimées après production. Conformité RGPD. ### Y a-t-il des limites de débit ? Les routes documentées autorisent 1200 requêtes par minute et par clé d'API. Chaque réponse porte les en-têtes RateLimit, et une réponse 429 porte Retry-After. ### Comment fonctionne le versionnement de l'API ? La version courante est /v2\. La version 1 (/v1) est dépréciée depuis le 25 octobre 2026 et sera retirée le 4 janvier 2027 : chaque réponse documentée de la version 1 porte les en-têtes Deprecation et Sunset et un lien Link vers son équivalent en version 2. ## Prêt à intégrer ? Créez votre compte et accédez à la sandbox en 2 minutes. Documentation complète disponible. [Créer mon compte intégrateur](https://dashboard.printags.com/register)[Documentation API](https://docs.printags.com)