Per gli sviluppatori

Integrazione API

Automatizza la produzione di tessere dal tuo sistema. REST API, webhook, documentazione completa.

Vai alla documentazione Parla con un tecnico

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

SDK e CLI Printags per l'API

// 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": "[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" }
  }]
}

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}/ordersCreare un ordine, come bozza o definitivo (intestazione Idempotency-Key supportata)

GET/v2/accounts/{accountId}/orders/{orderId}Leggere un ordine

GET/v2/accounts/{accountId}/ordersElencare gli ordini, con paginazione

POST/v2/accounts/{accountId}/filesCaricare un file di grafica

GET/v2/productsCatalogo dei prodotti

POST/v2/shipping/ratesPrezzi di spedizione per una destinazione

POST/v2/accounts/{accountId}/orders/{orderId}/validateConvalidare un ordine in bozza

GET/v2/statusesStati 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

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 Documentazione API