QRCode Suiteplataforma QR
Iniciar sessãoComece grátis →
Programadores

API de códigos QR para programadores

O QRCode Suite expõe uma API REST versionada na plataforma: crie códigos QR, altere destinos e leia análises de scans com o mesmo motor do painel. A autenticação usa chaves API com scopes criadas no dashboard. Um endpoint de conversões, webhooks assinados com HMAC e um píxel JavaScript estão a ser lançados junto com o relatório de conversões.

Acesso à API incluído nos planos Business e Agency.

Começar grátis →Ver preços

QR code CRUD endpoints

List, create, update, archive, and duplicate QR codes under /api/v1/qrcodes. Changing a destination via PATCH takes effect on the very next scan — the printed code never changes.

Scoped API keys

Mint API keys from the dashboard with read-only or read-write scopes and per-key rate limits. Keys are workspace-bound; keep them server-side, never in browser code.

Scan analytics over the API

Pull scans, devices, countries, referrers, and unique-visitor counts per code from /api/v1/qrcodes/:id/analytics — the same privacy-first data the dashboard charts, with no raw IPs anywhere.

Conversion API (rolling out)

POST purchase and signup events to /api/v1/events/conversion to attribute revenue back to the scan that produced it. Rolling out together with campaign ROI reporting.

Webhooks (rolling out)

Subscribe endpoints to scan and conversion events. Deliveries are HMAC-signed so your handler can verify authenticity, with retry-and-backoff on transient failures.

JavaScript pixel (rolling out)

A lightweight, consent-aware pixel links on-site conversions to prior QR scans without cookies or fingerprinting — designed to match the platform’s no-raw-IP privacy model.

Os endpoints na prática

Pedidos JSON de entrada e saída, autenticados com chave API Bearer.

curl -X POST https://qrcode-suite.com/api/v1/qrcodes \
  -H "Authorization: Bearer $QRCS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "dynamic_url",
    "name": "Spring packaging insert",
    "destination": "https://example.com/spring-landing"
  }'
# Re-point a printed code — no reprint needed
curl -X PATCH https://qrcode-suite.com/api/v1/qrcodes/qr_8f3k2 \
  -H "Authorization: Bearer $QRCS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "destination": "https://example.com/summer-landing" }'
# Conversion API (rolling out)
curl -X POST https://qrcode-suite.com/api/v1/events/conversion \
  -H "Authorization: Bearer $QRCS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "order_id": "1042",
    "value": 49.90,
    "currency": "EUR"
  }'

Perguntas frequentes

O que é o QRCode Suite?

O QRCode Suite é uma plataforma QR independente: crie uma conta gratuita e gere códigos QR dinâmicos e personalizados no browser — sem precisar de WordPress. Os conectores levam os mesmos códigos ao WordPress e ao WooCommerce, onde os pedidos podem ser atribuídos a códigos QR específicos.

O QRCode Suite funciona sem WordPress?

Sim. O QRCode Suite é um SaaS independente: registe-se, crie códigos QR e acompanhe as leituras inteiramente em qrcode-suite.com. O plugin WordPress é um conector opcional que traz os seus códigos para o wp-admin e adiciona a atribuição de encomendas WooCommerce.

O QRCode Suite exige uma subscrição separada?

O plano Free está disponível sem custos — sem cartão de crédito. Os planos pagos (Pro 9 €, Business 29 €, Agency 79 € por mês) desbloqueiam códigos ilimitados, regras de redireccionamento e mais. Não existe taxa por leitura.

Que tipos de códigos QR suporta o QRCode Suite?

O QRCode Suite suporta 22 tipos de códigos QR: URL estático, URL dinâmico, Texto simples, Telefone, Email, Localização, Link Hub, SMS, WhatsApp, Wi-Fi, vCard, Perfil social, PDF, Descarga de ficheiro, Descarga de app, Cupão, Evento de calendário, Formulário de captação de leads, Recolha de avaliações, Pedido grossista, Recompensa de fidelidade e Payload personalizado.

Posso alterar o destino de um código QR depois de o imprimir?

Sim. Os códigos QR dinâmicos usam um URL de redireccionamento curto. Pode actualizar o destino a partir do seu painel a qualquer momento, sem gerar ou imprimir novamente o código.

O QRCode Suite é conforme com o RGPD?

O QRCode Suite foi concebido a pensar no RGPD: nunca são guardados endereços IP em bruto — os visitantes são contados com hashes com chave —, o tráfego de bots é filtrado automaticamente e os eventos de digitalização são eliminados quando termina a janela de retenção do seu plano. Consulte a sua equipa jurídica para as obrigações específicas.

Construa sobre a API do QRCode Suite

Chaves API com scopes e endpoints REST — incluídos a partir de Business.

Ver plano BusinessLer documentação