Démarrage rapide
Créez votre premier code QR dynamique en moins d’une minute. Les codes MostlyQR sont dynamiques — vous imprimez le code une fois et pouvez changer sa destination à tout moment, avec analyse des scans intégrée. La plupart des gens utilisent le tableau de bord ; ce guide concerne l’API REST.
# 1. Obtenez 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 jeton Bearer sur chaque requête. Voir
Authentification.
# 2. Créez 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 générateur du tableau de bord) et imprimez-le. Chaque
scan redirige avec un 302 vers la destination — et est comptabilisé.
# 3. Changez sa destination — 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 vers la nouvelle URL, instantanément. Le code n’expire jamais — même si vous arrêtez de payer, il gèle à sa dernière destination au lieu de retourner une 404.
# 4. Lisez les scans
curl "https://mostlyqr.com/api/v1/links/AZ4K9/analytics?range=30d" \
-H "Authorization: Bearer mtq_live_…"
Voir Analyse pour la forme complète (géolocalisation, appareil, heure).
# Étapes suivantes
- Liens dynamiques — toutes les options pour les endpoints
/v1/links. - Lot — créez des milliers de codes en un seul appel.
- Codes sérialisés — un code unique par unité physique (Enterprise).
- Vérification — la vérification publique « est-ce authentique ? ».
- La référence API complète.