Quickstart de la API REST
- 1
Cree una clave API
En admin WordPress: QR Suite → Claves API → Crear. Nombre la clave, elija scope (`read`, `read-write` o `admin`), copie el secreto inmediatamente — solo se muestra una vez. Formato: `qcs_live_<32-hex>`. Guárdela en su entorno como `QCS_API_KEY`.
- 2
Cree un QR dinámico
POST a `/wp-json/meliqs/v1/qrs` con cabecera `Authorization: Bearer $QCS_API_KEY` y cuerpo `{"type": "url", "target": "https://example.com/landing", "name": "test API"}`. Devuelve id, URL corta codificada y metadatos. Guarde el id para las dos llamadas siguientes.
- 3
Obtenga la analítica
GET `/wp-json/meliqs/v1/qrs/{id}/scans?from=2026-01-01&to=2026-05-01` devuelve eventos paginados: IP hasheada, país, dispositivo, referrer, UTM. Tamaño página por defecto 100; `page=2&per_page=200` para consultas mayores hasta 1000 por página.
- 4
Actualice el destino
PATCH `/wp-json/meliqs/v1/qrs/{id}` con cuerpo `{"target": "https://example.com/new-destination"}`. Devuelve 200 con el registro actualizado. El QR impreso resuelve inmediatamente al nuevo URL — sin reimprimir, sin purga caché.
- 5
Webhooks para escaneos en tiempo real
Suscriba una URL webhook para recibir cada evento: POST a `/wp-json/meliqs/v1/webhooks` con cuerpo `{"url": "https://su-servidor.example/scan-hook", "events": ["scan.created"]}`. Cada escaneo ahora dispara un POST firmado HMAC a su endpoint en menos de 200 ms.
Preguntas frecuentes
¿Qué es QRCode Suite?
QRCode Suite es un plugin premium para WordPress que genera códigos QR dinámicos y personalizados directamente desde su panel de WordPress. Los datos de escaneo se almacenan en su propio servidor — no en una plataforma SaaS de terceros — y los pedidos de WooCommerce pueden atribuirse a códigos QR específicos.
¿QRCode Suite requiere una suscripción aparte?
El plan Free está disponible sin coste. Los planes de pago (Pro, Business, Agency) se licencian por sitio WordPress y se facturan mensual o anualmente. No hay tarifa por escaneo.
¿Qué tipos de códigos QR admite QRCode Suite?
QRCode Suite admite 15 tipos de códigos QR: URL, vCard, Wi-Fi, SMS, Email, WhatsApp, PDF, Cupón, Texto plano, Perfil social, Producto WooCommerce, Recompra WooCommerce, Link Hub, Teléfono y URL dinámica.
¿Puedo cambiar el destino de un código QR después de imprimirlo?
Sí. Los códigos QR dinámicos utilizan una URL de redirección corta. Puede actualizar el destino desde su panel de WordPress en cualquier momento, sin regenerar ni reimprimir el código.
¿QRCode Suite cumple con el RGPD?
Sí. QRCode Suite hashea las direcciones IP con SHA-256 antes de almacenarlas, por lo que nunca se guardan IPs en bruto. Además filtra automáticamente el tráfico de bots e incluye ajustes de retención de datos configurables.
¿Necesita ayuda para empezar?
Descargue el plugin gratuito o consulte toda la documentación.