ForHosting KIT · Strumenti per sviluppatori

Codice QR dinamico

Un codice QR dinamico non contiene direttamente il link finale, ma un indirizzo del KIT che reindirizza dove decidi tu in quel momento. Questo strumento crea quel reindirizzamento: puoi cambiare la destinazione quante volte vuoi, e il codice QR già stampato continua a funzionare senza bisogno di ristamparlo.

● Stabileper richiesta + per codice QR$0.002

Esegui — $0.002 + $0.005/codice QR Vedi l'API

Usalo da WebAPIEmailApp prestoTelegram presto

Esegui online

Esegui questo sui nostri server con il tuo account. Gli strumenti gratuiti girano nel tuo browser; questo viene addebitato sul tuo saldo KIT al prezzo indicato sopra.

La differenza con un QR normale

Un codice QR statico contiene il link finale scritto per sempre nel disegno: cambiarlo significa rifare il codice e ristampare tutto. Un codice QR dinamico contiene invece un indirizzo intermedio che reindirizza alla destinazione che hai impostato: puoi aggiornarla in qualsiasi momento dalla pagina o via API, e il codice stampato resta identico, senza che nessuno se ne accorga da fuori.

Perché serve un servizio, non solo un’immagine

Il reindirizzamento deve restare attivo e raggiungibile nel tempo, non è un file statico che generi una volta e basta: qualcuno deve tenere aggiornata la mappa tra il codice e la destinazione corrente. Per questo la creazione e la gestione del QR dinamico sono a pagamento, mentre il codice QR statico, che non richiede questo servizio continuo, resta gratis nel browser.

Un caso tipico: il menu che cambia stagione

Un ristorante stampa il codice QR dinamico sul tavolo una volta sola, all’apertura. A ogni cambio di stagione il gestore aggiorna solo la destinazione — la nuova pagina del menu — senza toccare le etichette già stampate su tutti i tavoli. Lo stesso vale per un cartellone pubblicitario che punta a campagne diverse nel corso dell’anno, senza mai essere ristampato.

Prezzo del servizio

Creare e mantenere un codice QR dinamico costa $0.002 alla creazione più $0.005 per il reindirizzamento, prezzo pubblicato, senza abbonamento nascosto: paghi il servizio che tiene vivo il collegamento tra il codice stampato e la destinazione che scegli, non solo l’immagine generata la prima volta. È lo stesso principio di un dominio che va rinnovato: qui rinnovi implicitamente ogni volta che aggiorni la destinazione.

Casi d'uso

Menu di stagione senza ristampare

Un ristorante di Verona stampa il codice QR dinamico una volta sola sui tavolinetti; a ogni cambio di menu stagionale aggiorna solo la destinazione, senza toccare le etichette già in sala.

Cartellone pubblicitario con campagne diverse

Rossi & Figli S.r.l. affitta uno spazio pubblicitario per un anno: cambia la destinazione del codice QR ogni mese secondo la campagna in corso, senza dover pagare una nuova stampa ogni volta.

Packaging che rimanda alla scheda giusta

Un piccolo produttore alimentare aggiorna la scheda prodotto collegata al codice QR sulla confezione quando cambia la ricetta, senza dover smaltire le etichette già stampate con la versione precedente.

Domande frequenti

Cosa cambia rispetto a un codice QR normale?

Il QR normale contiene il link finale per sempre; il dinamico contiene un indirizzo intermedio che reindirizzi dove vuoi, modificabile senza ristampare il codice.

Quanto costa un codice QR dinamico?

$0.002 alla creazione più $0.005 per il reindirizzamento, prezzo pubblicato, senza abbonamento: nessun costo nascosto oltre quanto dichiarato.

Posso cambiare la destinazione tutte le volte che voglio?

Sì, non c’è limite al numero di volte in cui aggiorni l’indirizzo verso cui reindirizza.

Il codice smette mai di funzionare?

Resta attivo finché mantieni il servizio: se lo elimini, il codice stampato smette di reindirizzare, quindi conviene pensarci prima di distruggere le etichette già stampate.

Posso vedere quanti l’hanno scansionato?

Sì, con lo strumento dedicato alle statistiche del link, che conta ogni apertura del reindirizzamento.

È disponibile gratis nel browser come il QR statico?

No: il QR dinamico richiede un servizio di reindirizzamento sempre attivo, quindi è a pagamento anche quando lo crei dalla pagina web.

Per sviluppatori — accesso via API

Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.

Endpoint

POSThttps://api.kit.forhosting.com/dev/qr-dynamic

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

Chiamala dal tuo stack

curl -X POST https://api.kit.forhosting.com/dev/qr-dynamic \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"input":"…"}'

const res = await fetch("https://api.kit.forhosting.com/dev/qr-dynamic", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "input": "…"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/dev/qr-dynamic",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "input": "…"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/dev/qr-dynamic", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => &#39;{"input":"…"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"input":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/dev/qr-dynamic", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Esempio di richiesta

{
  "input": "…"
}

Esempio di risposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "dev.qr_dynamic",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.

Prezzi

per richiesta$0.002

per codice QR$0.005

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

Errori

HTTP	Codice	Significato
`401`	`unauthorized`	Chiave API mancante o non valida: controlla l'header Authorization.
`402`	`insufficient_balance`	Credito esaurito: ricarica per continuare a eseguire attività.
`404`	`unknown_type`	Tipo di attività sconosciuto: controlla il campo type della richiesta.
`429`	`rate_limited`	Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →