QRCode Suitepara WordPress
Iniciar sessãoComece gratuitamente →
Documentação

Quickstart da API REST

O QRCode Suite expõe uma API REST versionada em `/wp-json/meliqs/v1/` na instalação WordPress. Este walkthrough leva-o da criação da primeira chave API à geração de um QR e ao acesso aos scans — cinco pedidos HTTP no total, com exemplos curl e Postman em cada passo.

  1. 1

    Crie uma chave API

    No admin WordPress: QR Suite → Chaves API → Criar. Nomeie a chave, escolha um scope (`read`, `read-write` ou `admin`), copie o segredo imediatamente — só é mostrado uma vez. Formato: `qcs_live_<32-hex>`. Guarde-a no seu env como `QCS_API_KEY`.

  2. 2

    Crie um QR dinâmico

    POST em `/wp-json/meliqs/v1/qrs` com header `Authorization: Bearer $QCS_API_KEY` e body `{"type": "url", "target": "https://example.com/landing", "name": "teste API"}`. Devolve o id do QR, o URL curto codificado, os metadados. Guarde o id para as duas chamadas seguintes.

  3. 3

    Obtenha a análise

    GET `/wp-json/meliqs/v1/qrs/{id}/scans?from=2026-01-01&to=2026-05-01` devolve eventos paginados: IP hashado, país, dispositivo, referrer, UTM. Tamanho de página padrão 100; `page=2&per_page=200` para queries maiores até 1000 por página.

  4. 4

    Atualize o destino

    PATCH `/wp-json/meliqs/v1/qrs/{id}` com body `{"target": "https://example.com/new-destination"}`. Devolve 200 com o registo atualizado. O QR impresso resolve imediatamente para o novo URL — sem reimpressão, sem purga de cache.

  5. 5

    Webhooks para scans em tempo real

    Subscreva um URL webhook para receber cada evento: POST em `/wp-json/meliqs/v1/webhooks` com body `{"url": "https://o-seu-servidor.example/scan-hook", "events": ["scan.created"]}`. Cada scan agora dispara um POST assinado HMAC para o seu endpoint em menos de 200 ms.

Perguntas frequentes

O que é o QRCode Suite?

O QRCode Suite é um plugin WordPress premium que gera códigos QR dinâmicos e personalizados directamente do seu painel WordPress. Os dados de leitura são guardados no seu próprio servidor — não numa plataforma SaaS de terceiros — e os pedidos do WooCommerce podem ser atribuídos a códigos QR específicos.

O QRCode Suite exige uma subscrição separada?

O plano Free está disponível sem custos. Os planos pagos (Pro, Business, Agency) são licenciados por site WordPress e facturados mensal ou anualmente. Não existe taxa por leitura.

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

O QRCode Suite suporta 15 tipos de códigos QR: URL, vCard, Wi-Fi, SMS, Email, WhatsApp, PDF, Cupão, Texto simples, Perfil social, Produto WooCommerce, Repetição de encomenda WooCommerce, Link Hub, Telefone e URL dinâmico.

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 WordPress a qualquer momento, sem gerar ou imprimir novamente o código.

O QRCode Suite é conforme com o RGPD?

Sim. O QRCode Suite aplica hashing SHA-256 aos endereços IP antes de os armazenar, pelo que nenhum IP em claro é guardado. Também filtra automaticamente tráfego de bots e inclui definições de retenção de dados configuráveis.

Precisa de ajuda para começar?

Descarregue o plugin gratuito ou consulte toda a documentação.

Descarregar o pluginToda a doc