MostlyQR

Início rápido

Crie seu primeiro código QR dinâmico em menos de um minuto. Os códigos MostlyQR são dinâmicos — você imprime o QR uma vez e muda para onde ele aponta para sempre, com análises de escaneamento integradas. A maioria das pessoas usa o painel; este guia é para a API REST.

# 1. Obtenha uma chave de API

Crie uma chave no aplicativo em Configurações → Chaves de API. As chaves se parecem com mtq_live_… (produção) ou mtq_test_… (teste). Envie como um token Bearer em cada requisição. Consulte Autenticação.

bash
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" }'
json
{
  "code": "AZ4K9",
  "short_url": "https://mqr.sh/AZ4K9",
  "destination_url": "https://northbrew.co/spring-menu",
  "title": "Spring menu",
  "status": "active"
}

Converta short_url em um QR (qualquer gerador ou o construtor do painel) e imprima. Cada escaneamento faz um redirecionamento 302 para o destino — e é contado.

# 3. Mude para onde ele aponta — sem reimprimir

bash
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" }'

Toda cópia já impressa agora resolve para a nova URL, instantaneamente. O código nunca expira — mesmo se você parar de pagar, ele congela no seu último destino em vez de retornar 404.

# 4. Leia os escaneamentos

bash
curl "https://mostlyqr.com/api/v1/links/AZ4K9/analytics?range=30d" \
  -H "Authorization: Bearer mtq_live_…"

Consulte Análise para a forma completa (geo, dispositivo, hora).

# Próximos passos