Creare codici QR da un software o da un agente IA
Con un piano Pro o Entreprise, QR Suisse, generatore di codici QR dinamici pubblicato da Skyday Sàrl, si comanda tramite un<api>API REST</api>: creare un codice QR (link o biglietto da visita), cambiarne la destinazione, scaricarne limmagine PNG o SVG e leggerne le statistiche. Un agente IA la usa con una chiave API che gli fornite tramite la sua configurazione. Per imparare l'API, l'agente può collegarsi al server MCP pubblico di QR Suisse, che dà accesso alla documentazione in sola lettura.
Cosa permette l'API
- Creare un codice QR di tipo link (URL) o biglietto da visita (vCard), con una denominazione.
- Modificarne la destinazione dopo la stampa, archiviarlo o riattivarlo.
- Scaricarne l'immagine in SVG (per la stampa) o PNG.
- Leggere il numero di scansioni, in totale e al giorno.
- Applicare un modello di stile già creato nella dashboard.
- Elencare e cercare i codici QR dell'account.
La documentazione completa e la specifica OpenAPI sono pubbliche: https://www.qrsuisse.ch/openapi.json.
Tre passi per un'integrazione
- Creare una chiave API nella dashboard. Solo un membro con il permesso «Gestore delle chiavi API» (o amministratore) può farlo, e sceglie i diritti della chiave: creare, leggere, modificare, eliminare, leggere le statistiche.
- Fornire la chiave al vostro programma o agente tramite la sua configurazione, ad esempio una variabile d'ambiente. Non incollatela mai in una conversazione.
- Chiamare l'API in HTTPS, con l'intestazione
Authorization: Bearer <chiave>.
Un agente IA che conosce la documentazione: il server MCP
Il server MCP pubblico di QR Suisse permette a un assistente compatibile (Claude Code, Visual Studio Code e altri client MCP) di cercare nella documentazione e di leggerne ogni pagina: guide, prezzi e una pagina per ogni operazione dell'API. Ha due strumenti, in sola lettura: qr_suisse_search_docs e qr_suisse_get_page.
- Non ha accesso ad alcun account e non crea codici QR.
- Non richiede né registrazione né chiave.
- Accetta 60 richieste al minuto per indirizzo.
L'indirizzo e la configurazione di ogni client si trovano sulla pagina Server MCP.
Limiti da conoscere prima di iniziare
- L'API è riservata ai piani Pro ed Entreprise.
- Ogni piano permette un numero di chiavi attive: 1 con Pro, 10 con Entreprise.
- Le creazioni via API sono limitate per mese civile: 5 con Pro, 100 con Entreprise, poi pacchetti di creazioni ad acquisto unico. Modificare, leggere o scaricare un codice QR non consuma nulla.
- La documentazione per gli agenti è in inglese; la specifica OpenAPI esiste anche in italiano.
Domande frequenti
Un agente IA può creare da solo un codice QR con QR Suisse?
Il server MCP dà accesso ai miei codici QR?
L'API è disponibile con il piano Gratuito?
Si può modificare via API un codice QR già stampato?
Altri casi d'uso
Codice QR statico o dinamico: quale scegliere?
Cosa permette ogni tipo, da cosa dipende e quale scegliere per un supporto stampato.
Codice QR per biglietti da visita
I Suoi recapiti restano aggiornati sui biglietti già stampati.
Codici QR per volantini e manifesti
Un codice QR per versione, correggibile dopo la stampa, per agenzie e tipografie.