Guida rapida
Crea il tuo primo codice QR dinamico in meno di un minuto. I codici MostlyQR sono dinamici — stampi il codice QR una volta e puoi cambiare dove punta per sempre, con analitiche delle scansioni integrate. La maggior parte delle persone usa il dashboard; questa guida riguarda l’API REST.
# 1. Ottieni una chiave API
Crea una chiave nell’app sotto Settings → API keys. Le chiavi hanno questo aspetto: mtq_live_…
(produzione) o mtq_test_… (testing). Inviale come token Bearer su ogni richiesta. Vedi
Authentication.
# 2. Crea un collegamento dinamico
curl https://mostlyqr.com/api/v1/links \
-H "Authorization: Bearer mtq_live_…" \
-H "Content-Type: application/json" \
-d '{ "destination_url": "https://northbrew.co/spring-menu", "title": "Spring menu" }'
{
"code": "AZ4K9",
"short_url": "https://mqr.sh/AZ4K9",
"destination_url": "https://northbrew.co/spring-menu",
"title": "Spring menu",
"status": "active"
}
Converti short_url in un codice QR (qualsiasi generatore, o il builder del dashboard) e stampalo. Ogni scansione esegue un reindirizzamento 302 alla destinazione — e viene conteggiata.
# 3. Cambia dove punta — senza ristampa
curl -X PATCH https://mostlyqr.com/api/v1/links/AZ4K9 \
-H "Authorization: Bearer mtq_live_…" \
-H "Content-Type: application/json" \
-d '{ "destination_url": "https://northbrew.co/summer-menu" }'
Ogni copia già stampata ora si risolve nel nuovo URL, istantaneamente. Il codice non scade mai — anche se smetti di pagare, si blocca sulla sua ultima destinazione invece di dare errore 404.
# 4. Leggi le scansioni
curl "https://mostlyqr.com/api/v1/links/AZ4K9/analytics?range=30d" \
-H "Authorization: Bearer mtq_live_…"
Vedi Analytics per la struttura completa (geo, dispositivo, ora).
# Passaggi successivi
- Dynamic links — ogni opzione per gli endpoint
/v1/links. - Batch — crea migliaia di codici in una sola chiamata.
- Serialized codes — un codice univoco per unità fisica (Enterprise).
- Verification — il controllo pubblico “è questo autentico?”.
- Il riferimento API completo.