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 la destinazione per sempre, con analitiche di scansione integrate. La maggior parte delle persone utilizza il dashboard; questa guida riguarda l’API REST.
# 1. Ottieni una chiave API
Crea una chiave nell’app sotto Impostazioni → Chiavi API. Le chiavi hanno il formato mtq_live_… (produzione) o mtq_test_… (testing). Inviala come Bearer token in ogni richiesta. Vedi Autenticazione.
# 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 302-reindirizza alla destinazione — e viene conteggiata.
# 3. Cambia la destinazione — senza ristampare
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 si risolve ora al nuovo URL, istantaneamente. Il codice non scade mai — anche se smetti di pagare, rimane sulla sua ultima destinazione invece di dare un 404.
# 4. Leggi le scansioni
curl "https://mostlyqr.com/api/v1/links/AZ4K9/analytics?range=30d" \
-H "Authorization: Bearer mtq_live_…"
Vedi Analitiche per la forma completa (geo, dispositivo, ora).
# Passaggi successivi
- Collegamenti dinamici — ogni opzione per gli endpoint
/v1/links. - Batch — crea migliaia di codici in una sola chiamata.
- Codici serializzati — un codice univoco per unità fisica (Enterprise).
- Verifica — il controllo pubblico “è questo autentico?”.
- Il Riferimento API completo.