Guía de inicio rápido
Crea tu primer código QR dinámico en menos de un minuto. Los códigos MostlyQR son dinámicos — imprimes el código QR una vez y puedes cambiar a dónde apunta para siempre, con análisis de escaneos incorporados. La mayoría de personas usan el dashboard; esta guía trata sobre la API REST.
# 1. Obtén una clave API
Crea una clave en la aplicación en Configuración → Claves API. Las claves se ven así: mtq_live_… (producción) o mtq_test_… (testing). Envíala como un token Bearer en cada solicitud. Consulta Autenticación.
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"
}
# 2. Crea un enlace dinámico
Convierte short_url en un código QR (usa cualquier generador o el constructor del dashboard) e imprímelo. Cada escaneo hace una redirección 302 al destino — y se cuenta.
# 3. Cambia a dónde apunta — sin reimprimir
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" }'
Cada copia ya impresa ahora se resuelve a la nueva URL, instantáneamente. El código nunca caduca — incluso si dejas de pagar, se mantiene en su último destino en lugar de devolver un 404.
# 4. Lee los escaneos
curl "https://mostlyqr.com/api/v1/links/AZ4K9/analytics?range=30d" \
-H "Authorization: Bearer mtq_live_…"
Consulta Análisis para ver la estructura completa (geo, dispositivo, hora).
# Próximos pasos
- Enlaces dinámicos — todas las opciones para los endpoints
/v1/links. - Lote — crea miles de códigos en una sola llamada.
- Códigos serializados — un código único por unidad física (Enterprise).
- Verificación — la verificación pública “¿es esto genuino?”.
- La referencia completa de API.