Démarrage rapide
Créez votre premier code QR dynamique en moins d’une minute. Les codes MostlyQR sont dynamiques — vous imprimez le code QR une fois et vous pouvez changer où il pointe indéfiniment, avec des analyses de scan intégrées. La plupart des gens utilisent le tableau de bord ; ce guide concerne l’API REST.
# 1. Obtenir une clé API
Créez une clé dans l’application sous Paramètres → Clés API. Les clés ressemblent à mtq_live_…
(production) ou mtq_test_… (test). Envoyez-la comme un jeton Bearer à chaque requête. Voir
Authentification.
# 2. Créer un lien dynamique
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"
}
Convertissez short_url en QR (n’importe quel générateur, ou le constructeur du tableau de bord) et imprimez-le. Chaque
scan redirige en 302 vers la destination — et est compté.
# 3. Changer où il pointe — sans réimpression
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" }'
Chaque copie déjà imprimée se résout maintenant sur la nouvelle URL, instantanément. Le code n’expire jamais — même si vous arrêtez de payer, il se fige sur sa dernière destination au lieu de renvoyer une erreur 404.
# 4. Lire les analyses
curl "https://mostlyqr.com/api/v1/links/AZ4K9/analytics?range=30d" \
-H "Authorization: Bearer mtq_live_…"
Voir Analyses pour la forme complète (géographie, appareil, temps).
# Prochaines étapes
- Liens dynamiques — chaque option pour les points de terminaison
/v1/links. - Lot — créez des milliers de codes en un seul appel.
- Codes sérialisés — un code unique par unité physique (Entreprise).
- Vérification — la vérification publique « est-ce authentique ? ».
- La référence API complète.