ForHosting KIT · Utilidades de desarrollo

Poner su logo en un QR

Poner un logo en medio de un código QR sin cuidado puede romperlo: el centro es justo donde la corrección de errores tiene menos margen para compensar. Esta API coloca su logo dentro de un código QR usando el diseño y el margen de corrección de errores necesarios para que siga siendo confiablemente escaneable, así la versión con marca funciona igual de bien que la versión simple.

● EstableGratis · en su navegador

Ejecutar — gratis Cómo funciona y API

Úselo desde WebAPIEmailApp prontoTelegram pronto

Por qué un logo en el centro es más riesgoso de lo que parece

La corrección de errores de un código QR puede reconstruir cierto porcentaje de datos faltantes u obstruidos, y ese margen es justamente lo que hace posible superponer un logo, pero no es ilimitado. Si el logo es demasiado grande, está mal centrado, o el nivel de corrección es demasiado bajo para la cobertura que ocupa, termina con un código que se ve bien a simple vista y falla de forma intermitente en cámaras reales, muchas veces justo en condiciones de luz o ángulo que no probó. dev.qr_logo mantiene ese equilibrio dentro de márgenes seguros de forma automática.

Qué pasa cuando la llama

Envía el contenido del código QR —una URL, credenciales WiFi, una vCard o texto plano, las mismas opciones que la generación estándar— junto con la imagen de su logo y el formato de salida. La tarea corre de forma asíncrona con un task_id devuelto de inmediato, y el código con marca llega por webhook firmado o por un enlace firmado de 24 horas una vez renderizado, dimensionado y validado. Elija PNG para un uso de tamaño fijo como un volante impreso, o SVG cuando el código necesite escalar entre distintos tamaños de empaque o pantalla.

Qué significa realmente 'verificado como escaneable' aquí

Agregar un logo no es solo componer una imagen: significa elegir un nivel de corrección de errores lo bastante alto para absorber el espacio que ocupa el logo, dimensionarlo para que no exceda el área de cobertura segura, y conservar suficiente zona de silencio alrededor del código. El proceso calcula estos tres factores automáticamente según su logo, en vez de dejarle adivinar el nivel de corrección correcto y descubrir el error solo cuando alguien no pueda escanear el código terminado.

Dónde se usan realmente los códigos QR con marca

Empaques minoristas y exhibidores donde el QR necesita verse como parte de la marca y no como un agregado pegado encima. Señalización y gafetes de eventos donde un cuadro blanco y negro genérico desentonaría con el resto del sistema visual. Anuncios impresos y menús donde un código escaneable funciona además como un pequeño espacio de marca. Cualquier lugar donde una empresa quiera que el código mismo sea reconocible a simple vista, antes incluso de escanearlo.

Cómo encaja en un pipeline de diseño o catálogo

Como corre bajo el mismo patrón asíncrono que todo lo demás, puede generar desde un script un conjunto completo de códigos QR con marca, uno por SKU o sucursal: una importación de catálogo, un lote de gafetes de evento, menús por ubicación, y dejar que cada uno llegue como su propio webhook una vez validado, en vez de revisar códigos uno por uno en una herramienta de diseño.

Qué puede hacer con ella

Empaques de producto con marca

Agregue su logo al código QR que enlaza a la información del producto, para que el código se vea como parte del diseño del empaque y no como una calcomanía genérica.

Gafetes y señalización de eventos

Genere códigos QR con logo incrustado para gafetes y carteles que combinen con el resto del material de marca del evento.

Menús y anuncios impresos

Coloque un código QR con marca que enlace a un menú en línea o página de aterrizaje directamente en un anuncio impreso, sin que desentone junto al logo.

Materiales de socios y franquicias

Produzca códigos QR con marca a escala para varias sucursales de una franquicia, cada uno con su propio enlace de destino pero el mismo logo reconocible.

Preguntas frecuentes

¿Un logo hará que mi código QR deje de funcionar?

No si se coloca y dimensiona correctamente, que es justo lo que resuelve este endpoint: ajusta la corrección de errores y la cobertura del logo de forma automática para mantener el código confiablemente escaneable.

¿En qué formato debe estar la imagen del logo?

Los formatos de imagen rasterizados estándar funcionan como entrada del logo; el código QR de salida se entrega en PNG o SVG, a su elección.

¿Puedo usar cualquier tipo de contenido de QR con logo?

Sí: URL, credenciales WiFi, vCard y texto plano admiten todos la superposición de logo, las mismas opciones de contenido que la generación estándar de QR.

¿Es gratis para probar?

La herramienta de arriba es gratis en su navegador. La API es de pago: cada llamada se descuenta de su saldo prepago de ForHosting KIT — se recarga desde $10.00 (no caduca), se paga el precio publicado de cada solicitud, y una llamada sin saldo devuelve HTTP 402. Sin suscripción, sin tokens, y una tarea fallida no se cobra.

¿Cuánto cuesta?

0.002 dólares por solicitud más 0.005 dólares por cada imagen generada.

¿En qué se diferencia del generador de QR estándar?

El generador estándar produce un código QR simple; este endpoint incrusta y valida un logo dentro del código conservando su escaneabilidad confiable, algo que el endpoint estándar no intenta hacer.

¿Puedo generar códigos QR con marca en lote?

Sí: envíe cada generación de forma asíncrona y recolecte los resultados conforme llegan los webhooks, algo ideal para lotes por sucursal o por SKU.

¿Se cobran las generaciones fallidas?

No: las tareas fallidas se reintentan hasta tres veces y solo se cobran los resultados exitosos.

Para desarrolladores — acceso por API

Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.

Endpoint de API

POSThttps://api.kit.forhosting.com/dev/qr-logo

¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, y pronto desde nuestra app, el email y Telegram.

Llámela desde su stack

curl -X POST https://api.kit.forhosting.com/dev/qr-logo \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"image":"https://ejemplo.com/imagen.jpg"}'

const res = await fetch("https://api.kit.forhosting.com/dev/qr-logo", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "image": "https://ejemplo.com/imagen.jpg"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/dev/qr-logo",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "image": "https://ejemplo.com/imagen.jpg"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/dev/qr-logo", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => &#39;{"image":"https://ejemplo.com/imagen.jpg"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"image":"https://ejemplo.com/imagen.jpg"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/dev/qr-logo", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Ejemplo de solicitud

{
  "image": "https://ejemplo.com/imagen.jpg"
}

Ejemplo de respuesta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "dev.qr_logo",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.

Precio

Por solicitud$0.002

Por imagen$0.005

Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.

Errores

HTTP	Código	Significado
`401`	`unauthorized`	API key ausente o inválida.
`402`	`insufficient_balance`	El saldo no cubre el precio de la tarea.
`404`	`unknown_type`	El tipo de tarea no existe.
`429`	`rate_limited`	Demasiadas peticiones. Use el webhook en vez de sondear.

Ver la documentación completa del KIT →

Ejecutar — gratis