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álise de digitalizações integrada. A maioria das pessoas usa o painel; este guia é 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_… (testes). Envie-a como um token Bearer em cada solicitaçã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 digitalização redireciona 302 para o destino — e é contada.

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

Cada cópia já impressa agora é resolvida para a nova URL, instantaneamente. O código nunca expira — mesmo que você pare de pagar, ele congela no seu último destino em vez de devolver um 404.

# 4. Leia as digitalizações

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, tempo).

# Próximas etapas