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

// Créer une commande de carte

POST https://api.printags.com/v1/orders

{
  "card_type": "ntag213",
  "design": {
    "template_id": "tpl_abc123",
    "variables": {
      "name": "Jean Dupont",
      "title": "Directeur technique",
      "photo": "https://..."
    }
  },
  "nfc": {
    "url": "https://example.com/jean"
  },
  "shipping": {
    "name": "Jean Dupont",
    "address": "12 rue de la Paix",
    "city": "Paris",
    "country": "FR"
  }
}

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/v1/ordersCreare un ordine

GET/v1/orders/:idStato di un ordine

GET/v1/orders/:id/trackingTracking della spedizione

POST/v1/designsCaricare una grafica

GET/v1/templatesElencare i template

POST/v1/webhooksConfigurare un webhook

GET/v1/cards/:idDettagli di una tessera

GET/v1/billing/usageConsumo mensile

Webhook

Notifiche in tempo reale

Ricevi notifiche automatiche a ogni cambio di stato. Configura i webhook tramite API o dalla dashboard.

order.created

Ordine ricevuto e confermato

order.printing

Stampa in corso

order.encoding

Codifica NFC in corso

order.quality_check

Controllo qualità superato

order.shipped

Pacco spedito, numero di tracking disponibile

order.delivered

Consegna confermata

Sandbox e sicurezza

Prova in tutta sicurezza

L'ambiente sandbox replica l'API di produzione. Prova la tua integrazione senza costi e senza rischi.

Sandbox identica alla produzione
Chiavi API separate (test / produzione)
HTTPS obbligatorio su tutti gli endpoint
Rate limiting configurabile
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.

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 degli SDK?

L'API è una REST API standard (JSON su HTTPS). È compatibile con tutti i linguaggi e framework. Forniamo esempi di codice e collection Postman per iniziare rapidamente.

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 più costo unitario per tessera. L'endpoint /v1/billing/usage ti permette di monitorare il consumo in tempo reale. Fatturazione automatica 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.

Posso limitare le chiamate API dei miei utenti?

Sì, il rate limiting è configurabile. Di default, 100 richieste al minuto. Regolabile in base al tuo piano.

Pronto a integrare?

Crea il tuo account e accedi alla sandbox in 2 minuti. Documentazione completa disponibile.

Crea il tuo account integratore Documentazione API