Ir al contenido
Krealo QR
Idioma es
Cambiar el tema
Entrar

API de enlaces cortos y códigos QR

La API REST de Krealo QR permite crear enlaces cortos, listarlos, cambiar su destino y obtener su código QR desde tus propias herramientas. Está disponible solo en el plan Pro, por 5,99 $ al mes más impuestos. Generas un token personal en la página de tu cuenta y lo envías en la cabecera Authorization.

POST /links
curl -X POST https://qr.krealomedia.com/api/v1/links \
  -H "Authorization: Bearer kqr_…" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/menu","slug":"menu"}'
GET /links
curl https://qr.krealomedia.com/api/v1/links?limit=25 \
  -H "Authorization: Bearer kqr_…"
GET /links/{slug}
curl https://qr.krealomedia.com/api/v1/links/menu -H "Authorization: Bearer kqr_…"

{ "slug": "menu", "short_url": "https://qr.krealomedia.com/menu", "url": "https://example.com/menu",
  "active": true, "clicks": 42, "stats": { "by_day": { … }, "by_country": { "CA": 40 } } }
PATCH /links/{slug}
curl -X PATCH https://qr.krealomedia.com/api/v1/links/menu \
  -H "Authorization: Bearer kqr_…" -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/menu-hiver","active":true}'
GET /links/{slug}/qr
curl "https://qr.krealomedia.com/api/v1/links/menu/qr?format=svg" -H "Authorization: Bearer kqr_…" -o menu.svg

401 unauthorized · 402 pro_required · 404 not_found · 409 slug_taken · 429 rate_limited (120/min)

Autenticación

La API es solo para cuentas Pro. Genera tu token personal en la página de tu cuenta y envíalo en la cabecera Authorization: Bearer <token>. La URL base es https://qr.krealomedia.com/api/v1.

Rutas disponibles

  • GET /links: lista tus enlaces, con paginación por cursor.
  • POST /links: crea un enlace (campo url, identificador slug opcional).
  • GET /links/{slug}: devuelve un enlace con su número de clics.
  • PATCH /links/{slug}: cambia la url o el estado activo.
  • GET /links/{slug}/qr?format=svg|png: devuelve el código QR en blanco y negro.

Límite de uso

El límite es de 120 solicitudes por minuto. Si lo superas, espera al minuto siguiente antes de reintentar.

Destinos aceptados

Solo se aceptan direcciones http y https. Los destinos peligrosos, como javascript: o data:, se bloquean.

Ver también

Preguntas frecuentes

¿Quién puede usar la API?

Las cuentas del plan Pro. El token personal se genera en la página de la cuenta.

¿Cuál es el límite de solicitudes?

Es de 120 solicitudes por minuto.

¿El código QR que devuelve la API puede llevar logo?

No. La ruta /links/{slug}/qr devuelve un código QR en blanco y negro, en SVG o PNG. El logo y los colores se configuran desde la aplicación.