← Tutte le funzionalità

API REST — crei e gestisca i Suoi codici QR dai Suoi strumenti

Colleghi il Suo CRM, il Suo strumento di automazione o i Suoi script a QR Suisse: crei, modifichi ed elimini codici QR dinamici e ne legga le statistiche tramite l'API. Piani Pro ed Entreprise.

Pro · Entreprise

L'API REST di QR Suisse permette ai Suoi strumenti di creare, leggere, modificare ed eliminare codici QR di tipo link o biglietto da visita, di scaricarne l'immagine in PNG o in SVG e di leggerne le statistiche di scansione. I Suoi strumenti possono inoltre archiviare e riattivare un codice QR, cercare e filtrare l'elenco, leggere la quota di creazioni rimanente e inviare di nuovo una creazione senza duplicati, con l'header Idempotency-Key. Si richiama da qualsiasi strumento in grado di inviare una richiesta HTTPS: un CRM, uno script interno o uno strumento di automazione come Zapier o Make. Ogni chiave API riceve solo i diritti necessari (lettura, creazione, modifica, eliminazione, statistiche); viene mostrata una sola volta, poi può essere ruotata o revocata in qualsiasi momento finché il Suo account è nel piano Pro o Entreprise. Il piano Pro comprende 5 creazioni di codici QR tramite l'API per mese solare e 1 chiave attiva; il piano Entreprise, 100 creazioni per mese solare e fino a 10 chiavi attive contemporaneamente. Vengono conteggiate solo queste creazioni: leggere, modificare o eliminare un codice QR, o crearne uno nella dashboard, non viene conteggiato. Sono disponibili pacchetti di creazioni opzionali, con un abbonamento a pagamento attivo (vedi i prezzi). Il piano Gratuito non dà accesso all'API. La documentazione API descrive ogni endpoint e propone la specifica OpenAPI.

Schermata delle chiavi API in QR Suisse: una chiave con i suoi diritti, la data dell'ultimo utilizzo e la quota di creazioni del mese — account dimostrativo, dati fittizi.
Chiavi con diritti limitati, da ruotare o revocare in qualsiasi momento (account dimostrativo, piano Pro).

Domande frequenti

Quali piani danno accesso all'API?
I piani Pro ed Entreprise. Il piano Pro comprende 5 creazioni di codici QR tramite l'API per mese solare e 1 chiave attiva. Il piano Entreprise comprende 100 creazioni per mese solare, con fino a 10 chiavi attive contemporaneamente. Il piano Gratuito non dà accesso all'API.
Cosa viene conteggiato nella quota?
Solo la creazione di codici QR tramite l'API. Leggere, modificare, archiviare, riattivare, eliminare un codice QR, scaricarne l'immagine o leggerne le statistiche non viene conteggiato, e nemmeno un codice QR creato nella dashboard. Una creazione resta conteggiata anche se il codice QR viene eliminato in seguito. La quota viene azzerata il 1° di ogni mese alle 00:00 UTC (all'1:00 o alle 2:00 in Svizzera), senza riporto.
Dove posso seguire le creazioni utilizzate questo mese?
Nella schermata Chiavi API della dashboard, accessibile ai membri che dispongono del permesso «Gestore delle chiavi API» (o Amministratore). Il riquadro «Creazioni di codici QR tramite l'API questo mese» indica le creazioni incluse già utilizzate, le creazioni prelevate dai Suoi pacchetti e quelle che restano nei Suoi pacchetti, oltre alla data di azzeramento della quota. Tramite l'API, GET /usage restituisce le stesse cifre a una chiave con il diritto QR_CREATE.
Cosa succede quando la quota è esaurita?
Le creazioni utilizzano i Suoi pacchetti di creazioni, se ne ha ancora. Altrimenti, la creazione viene rifiutata (errore 429 quota_exceeded) fino all'azzeramento del 1° del mese successivo, o fino all'acquisto di un pacchetto. Nulla viene fatturato a consumo.
Posso archiviare o riattivare un codice QR tramite l'API?
Sì, un codice QR alla volta: una modifica con active impostato su false lo archivia, con true lo riattiva. Non viene conteggiata nella quota di creazioni. L'archiviazione conserva il contenuto e le statistiche. L'eliminazione definitiva, invece, è irreversibile: il codice QR e le sue statistiche vengono cancellati, e il suo indirizzo non potrà mai più essere utilizzato.
L'API gestisce i tag, le azioni di gruppo e le esportazioni?
No. I tag, la selezione multipla, il download in ZIP e l'esportazione CSV si effettuano nella dashboard, con i piani Pro ed Entreprise. Tramite l'API, legge l'elenco dei Suoi codici QR pagina per pagina, con ricerca (denominazione, destinazione e fine dell'indirizzo breve), filtri (stato, tipo, periodo di creazione) e ordinamento, ma senza filtro per tag, e scarica le immagini una alla volta.
Cosa devo fare nella dashboard anziché tramite l'API?
La configurazione dell'account: creare e gestire le chiavi API, invitare membri e impostarne i permessi, configurare il dominio personalizzato, gestire l'abbonamento e acquistare pacchetti di creazioni. La documentazione API confronta in dettaglio cosa fanno l'API e la dashboard.
Posso collegare l'API a Zapier, Make o a un agente IA?
Sì, a qualsiasi strumento in grado di inviare richieste HTTPS con una chiave. Per ora non esistono né un'integrazione ufficiale né un connettore dedicato agli assistenti IA (MCP). L'impostazione predefinita «Agente assistente IA» limita la chiave alla lettura.
Come proteggo una chiave API?
Le attribuisca solo i diritti necessari, richiami sempre l'API in https:// e conservi la chiave in un gestore di segreti: viene mostrata una sola volta. Se ha potuto essere esposta, la ruoti o la revochi dalla schermata Chiavi API. Nel piano Gratuito, in cui le Sue chiavi sono congelate e non vengono mostrate, scriva a contact@qrsuisse.ch dall'indirizzo e-mail di un amministratore dell'account.
C'è un limite al numero di chiamate?
Sì, per proteggere il servizio: 30 richieste al minuto per chiave, di cui al massimo 8 creazioni. Le immagini PNG sono inoltre limitate a 10 al minuto per l'intero account. Oltre questi limiti, l'API risponde 429 rate_limited con il tempo di attesa. Solo la creazione è inoltre soggetta alla quota mensile di creazioni.
Una creazione è stata interrotta da un'interruzione di rete: come inviarla di nuovo senza duplicati?
Invii ogni creazione con l'header Idempotency-Key: un nuovo valore casuale per ogni creazione (UUID v4 consigliato), senza dati personali. Se la risposta non arriva, invii di nuovo la stessa richiesta con lo stesso valore entro 24 ore: riceve il codice QR già creato, senza un secondo codice QR né una seconda creazione conteggiata nella quota. Senza questo header, verifichi l'elenco dei Suoi codici QR prima di inviarla di nuovo: una creazione riuscita resta conteggiata, anche se poi elimina il duplicato.

Pagine di aiuto

Provi QR Suisse

Il piano Gratuito è disponibile subito in self-service, senza carta di credito.

Crea un account gratuitoScopri il piano Pro