ForHosting KIT · Utilidades de desarrollo

Crear un código QR

Un código QR es algo pequeño y preciso: un nivel de corrección de errores equivocado, una zona de silencio insuficiente o un tamaño demasiado ajustado, y simplemente no se escanea. Esta API genera códigos QR de URL, credenciales WiFi, tarjetas de contacto (vCard) o texto plano, entregados en PNG o SVG, para que produzca cientos de códigos correctos y escaneables sin tocar una herramienta de diseño.

● EstableGratis · en su navegador
Úselo desde WebAPIEmailApp prontoTelegram pronto

Corre en su navegador. Gratis y sin límite: sus datos no salen de esta página.

Cuatro tipos de contenido, un solo endpoint

No todo código QR codifica una URL. Un código QR de WiFi lleva el nombre de la red, la contraseña y el tipo de cifrado, para que la cámara de un teléfono se una a la red sin que nadie escriba una contraseña. Un código QR de vCard incluye una tarjeta de contacto completa que se guarda directo en la libreta de direcciones. Un código QR de texto plano simplemente lleva una cadena, útil desde un número de serie hasta un mensaje corto. dev.qr_generate maneja los cuatro tipos con la misma forma de solicitud, así que su código de integración no se ramifica por caso de uso.

Cómo una solicitud se convierte en imagen

Envía el tipo de contenido y sus datos, más el formato de salida que quiera. La tarea se acepta de forma asíncrona con un task_id, y una vez renderizada, la imagen llega por webhook firmado o por un enlace firmado válido por 24 horas. El PNG conviene para impresión a tamaño fijo o visualización directa; el SVG es mejor cuando el código necesita escalar, por ejemplo en empaques que cambian de tamaño entre variantes, o en una página web adaptable.

Qué hace realmente confiable a un código QR

Que se pueda escanear no depende solo de que el patrón blanco y negro sea técnicamente correcto: depende de una zona de silencio adecuada, suficiente contraste, y un nivel de corrección de errores apropiado para cómo se va a imprimir o mostrar el código. Un código destinado a una caja de cartón que se puede rasgar necesita más corrección de errores que uno mostrado limpio en pantalla. El generador aplica valores por defecto razonables para cada tipo, para que no tenga que decidir esto manualmente.

Un breve apunte sobre el formato en sí

Los códigos QR se desarrollaron en los años noventa para rastrear piezas en líneas de ensamblaje automotriz, valorados por codificar mucha más información que un código de barras estándar en el mismo espacio y por leerse desde cualquier ángulo. Ese origen industrial explica en parte por qué el formato tolera tan bien la generación automatizada: se diseñó para imprimirse y escanearse de forma imperfecta, en el piso de una fábrica, no solo en un estudio de diseño.

Generar a escala sin una herramienta de diseño

Como cada llamada es independiente y asíncrona, esto encaja en pipelines de contenido: un código QR de WiFi único por habitación de hotel, un vCard QR por gafete de empleado, o un QR de URL por SKU durante una importación de catálogo; miles de códigos producidos desde un script, cada uno llegando como su propio webhook en vez de requerir un lote que haya que vigilar.

Acceso WiFi para huéspedes

Genere un código QR de WiFi único por habitación de hotel o gafete de evento, para que los huéspedes se conecten a la red con un escaneo en vez de escribir una contraseña.

Tarjetas de presentación digitales

Produzca un código QR de vCard para cada empleado, que guarda su información de contacto directo en la libreta de direcciones del teléfono en un stand de conferencia.

Empaques de producto

Genere un código QR en SVG que enlaza a la página del producto, con un tamaño que escala limpio entre variantes de empaque grandes y pequeñas.

Registro de entrada a eventos

Cree un código QR de texto plano que codifica un identificador de registro único por asistente, escaneado en la puerta para el check-in.

¿Qué tipos de código QR admite la API?

URL, credenciales de red WiFi, tarjetas de contacto vCard y texto plano; estos cuatro tipos cubren la gran mayoría de los casos de uso reales.

¿PNG o SVG, cuál elijo?

El PNG es un buen valor por defecto para impresión a tamaño fijo o visualización directa; el SVG conviene más cuando el código se va a redimensionar o incrustar en un diseño adaptable, porque se mantiene nítido en cualquier escala.

¿Generar códigos QR es gratis?

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.004 dólares por cada imagen generada.

¿Puedo generar códigos QR en lote?

Sí: cada llamada de generación es asíncrona e independiente, así que puede automatizar miles de solicitudes y procesar los webhooks resultantes conforme se completan.

¿El código QR se sigue escaneando si le agrego un logo?

Este endpoint genera códigos QR estándar sin logo; para un código con marca, logo incrustado y verificado como escaneable, use el endpoint dedicado de QR con logo.

¿Cuánto tardo en recibir la imagen del código QR?

La solicitud se acepta de inmediato con un task_id, y la imagen terminada se entrega por webhook firmado o por un enlace firmado de 24 horas una vez que termina el renderizado.

¿Se cobran las generaciones fallidas?

No: cada tarea tiene hasta tres reintentos y solo se cobra cuando el resultado es exitoso.

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.

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

¿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.

curl -X POST https://api.kit.forhosting.com/dev/qr-generate \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"https://forhosting.com/kit"}'
{
  "text": "https://forhosting.com/kit"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "dev.qr_generate",
  "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.

Por solicitud$0.002
Por imagen$0.0044

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

HTTPCódigoSignificado
401unauthorizedAPI key ausente o inválida.
402insufficient_balanceEl saldo no cubre el precio de la tarea.
404unknown_typeEl tipo de tarea no existe.
429rate_limitedDemasiadas peticiones. Use el webhook en vez de sondear.

Ver la documentación completa del KIT →