Guía rápida de la API de códigos QR

La API de QR Code Genius te permite generar códigos QR de forma programática: imágenes PNG totalmente personalizadas, lotes masivos con seguimiento de escaneos e imágenes ligeras que puedes incrustar directamente en una página web o un correo electrónico.

Crea una API key

1. Inicia sesión y abre el Panel de desarrolladores.
2. Haz clic en Crear API Key y asígnale un nombre.
3. Copia la clave inmediatamente: se muestra solo una vez. En nuestros servidores solo se guarda un hash seguro, por lo que una clave perdida debe revocarse y sustituirse.

Las claves tienen este aspecto:

qrc_9f8a7b6c5d4e3f2a1b0c9d8e7f6a5b4c...

URL base

https://www.qrcodegenius.com/api/v1

Tu primera solicitud

Pasa tu clave en el encabezado Authorization y envía por POST el contenido que quieres codificar:

curl -X POST https://www.qrcodegenius.com/api/v1/qr \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "data": "https://example.com", "width": 512, "height": 512 }'

La respuesta contiene el código QR como una data URL PNG en base64, junto con tu uso actual:

{
  "success": true,
  "data": "data:image/png;base64,iVBORw0KGgo...",
  "meta": { "usage_count": 1, "remaining": 49, "strategy": "monthly" }
}

Endpoints

• POST /qr — genera un único código QR totalmente personalizado. Consulta Generar un código QR.
• POST /qr/bulk — genera hasta 100 códigos QR en una sola llamada y guárdalos en tu cuenta, opcionalmente como códigos dinámicos con seguimiento (plan Pro). Consulta Generación masiva de códigos QR.
• GET /render — un PNG rápido y cacheable que puedes usar directamente en una etiqueta img. Consulta Incrustar una imagen QR.

Planes y límites

• Free: 50 solicitudes de API al mes.
• Pro: 1.000 solicitudes de API al mes, además de acceso a la generación masiva.
• Los créditos comprados se usan automáticamente cuando se agota la cuota mensual.

Consulta Errores y límites de uso para más detalles sobre cuotas y manejo de errores.