--- title: "API Printags: documentazione REST, OpenAPI, SDK e CLI | Printags" description: "API REST di Printags (OpenAPI): creare e seguire ordini di carte PVC e NFC, testare con chiavi sandbox, usare l'SDK e la CLI npm o il server MCP." canonical: "https://www.printags.com/it/integrazione-api/" --- # Integrazione API Automatizza la produzione di tessere dal tuo sistema. REST API, webhook, documentazione completa. [Vai alla documentazione](https://docs.printags.com)[Parla con un tecnico](https://app.monagence.pro/book/printags/decouvrir-printags) Integrazione rapida ## Semplice da integrare Basta una richiesta HTTP per avviare la stampa, la codifica NFC e la spedizione di una tessera. Webhook per il monitoraggio in tempo reale. * REST API con autenticazione tramite chiave API * Webhook per gli aggiornamenti di stato in tempo reale * Sandbox completa per provare senza costi * Documentazione OpenAPI (Swagger) completa * Risposte JSON standardizzate e paginate * Idempotenza sulle richieste di creazione Le stesse operazioni si possono gestire anche da un assistente IA. [Scopri il server MCP di Printags](https://www.printags.com/it/server-mcp/) [SDK e CLI Printags per l'API](https://www.printags.com/it/sdk-e-cli/) // Creare un ordine di tessera 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" } }] } Architettura ## Architettura di integrazione Il tuo sistema comunica con l'API Printags. A tutto il resto pensiamo noi. Il tuo sistema ERP, CRM, e-commerce, SaaS API RESTWebhooks Printags Stampa + codifica + spedizione Riferimento API ## Endpoint principali POST`/v2/accounts/{accountId}/orders`Creare un ordine, come bozza o definitivo (intestazione Idempotency-Key supportata) GET`/v2/accounts/{accountId}/orders/{orderId}`Leggere un ordine GET`/v2/accounts/{accountId}/orders`Elencare gli ordini, con paginazione POST`/v2/accounts/{accountId}/files`Caricare un file di grafica GET`/v2/products`Catalogo dei prodotti POST`/v2/shipping/rates`Prezzi di spedizione per una destinazione POST`/v2/accounts/{accountId}/orders/{orderId}/validate`Convalidare un ordine in bozza GET`/v2/statuses`Stati degli ordini Webhook ## Notifiche in tempo reale Ricevi notifiche automatiche quando un ordine cambia. Configura i webhook dalla dashboard. `order.created` Ordine creato `order.updated` Ordine aggiornato `order.shipped` Ordine spedito `order.delivered` Consegna confermata Sandbox e sicurezza ## Prova in tutta sicurezza Le chiavi di test (sk\_test\_...) creano ordini di prova che non vengono addebitati né fabbricati. Usa l'API di produzione con una chiave di test, oppure sandbox-api.printags.com, che accetta solo chiavi di test. * Gli ordini di prova non vengono mai addebitati né fabbricati * Chiavi API separate (test / produzione) * HTTPS obbligatorio su tutti gli endpoint * Limiti di utilizzo annunciati nelle intestazioni standard RateLimit * Log e cronologia di tutte le richieste Scenari di integrazione ## Come i nostri integratori usano l'API ### E-commerce Un cliente ordina una tessera sul tuo shop. L'API avvia automaticamente la produzione e la spedizione. ### SaaS / Piattaforma La tua piattaforma gestisce dei soci. A ogni iscrizione una tessera viene stampata e spedita automaticamente. ### HR / Corporate Nuovo dipendente = badge automatico. L'API si integra con il tuo gestionale HR per avviare la produzione. ### IoT / Colonnine Nuovo abbonato alla tua rete di colonnine = badge NFC stampato e spedito automaticamente tramite API. ### Eventi Iscrizioni online = badge personalizzati prodotti e inviati ai partecipanti prima dell'evento. ### Programma fedeltà Nuovo iscritto al tuo programma = carta fedeltà NFC stampata con dati variabili e codifica. Il tuo negozio usa WooCommerce, Shopify o PrestaShop? Non serve sviluppare. [Il plugin per WooCommerce, l'app per Shopify e il modulo per PrestaShop](https://www.printags.com/it/integrazioni/) Domande frequenti ## FAQ — Integrazione API ### Quanto tempo richiede l'integrazione? La maggior parte dei nostri integratori è operativa in meno di un giorno. La documentazione è completa, con esempi di codice in più linguaggi. Un ambiente sandbox è disponibile da subito. ### Sono disponibili SDK? Sì: il pacchetto npm printags (SDK e riga di comando per Node.js 18 o superiore, licenza MIT). L'API è anche una normale API REST descritta da un documento OpenAPI, quindi qualsiasi linguaggio può chiamarla. Vedere la pagina SDK e CLI. ### L'API è disponibile 24/7? Sì, l'API è disponibile 24 ore su 24, 7 giorni su 7\. Garantiamo uno SLA del 99,9% di disponibilità. Lo stato in tempo reale è consultabile sulla nostra pagina di stato. ### Come funziona la fatturazione? Abbonamento mensile + costo unitario per carta, fatturati automaticamente a fine mese. ### I dati trasmessi sono al sicuro? Sì. HTTPS obbligatorio su tutti gli endpoint. I dati personali (foto, nomi) sono cifrati a riposo ed eliminati dopo la produzione. Conformità al GDPR. ### Ci sono limiti di utilizzo? Le route documentate consentono 1200 richieste al minuto per chiave API. Ogni risposta contiene le intestazioni RateLimit, e una risposta 429 contiene Retry-After. ### Come funziona il versionamento dell'API? La versione corrente è /v2\. La versione 1 (/v1) è deprecata dal 25 ottobre 2026 e verrà rimossa il 4 gennaio 2027: ogni risposta documentata della versione 1 contiene le intestazioni Deprecation e Sunset e un Link al suo equivalente nella versione 2. ## Pronto a integrare? Crea il tuo account e accedi alla sandbox in 2 minuti. Documentazione completa disponibile. [Crea il tuo account integratore](https://dashboard.printags.com/register)[Documentazione API](https://docs.printags.com)