Leer un código QR
Leer un código QR a simple vista es imposible, y leerlo de forma confiable desde una foto tomada con el celular en ángulo, bajo la luz de una bodega, tampoco es sencillo para un decodificador ingenuo. Esta api para leer código qr toma una imagen y devuelve lo que sea que esté codificado dentro, ya sea una URL simple, un bloque de credenciales de Wi-Fi, una vCard o texto plano, para que su aplicación nunca tenga que implementar la lógica de decodificación por su cuenta.
Ejecutar — gratis
Corre en su navegador. Gratis y sin límite: sus datos no salen de esta página.
Por qué decodificar no es tan trivial como parece
La cuadrícula en blanco y negro de un código QR lleva corrección de errores, marcadores de posición e información de formato superpuestos al contenido real, y un decodificador tiene que ubicar todo eso correctamente antes de siquiera empezar a leer los datos. Un código fotografiado de frente bajo luz de oficina es fácil; ese mismo código fotografiado en ángulo pronunciado, con sombra parcial, impreso pequeño en una etiqueta de envío, o ligeramente desenfocado, es donde fallan la mayoría de los intentos simples de decodificación. Una lectura confiable tiene que tolerar la realidad desordenada de cómo la gente realmente fotografía las cosas, no solo la imagen de prueba perfecta.
Qué espera y qué devuelve POST /dev/qr-decode
Envía una imagen que contiene uno o más códigos QR. La tarea ubica cada código en el cuadro, lo decodifica, y devuelve el texto en bruto de cada uno encontrado, identificado por su posición si aparece más de un código en la misma imagen. Si la imagen no contiene ningún código legible, la tarea lo informa con claridad en lugar de devolver un resultado vacío o ambiguo.
El formato detrás del escaneo
QR, abreviatura de Quick Response, se diseñó en 1994 específicamente para ser leído rápido por un escáner que pasa junto a él en una línea de fábrica, por eso su estructura prioriza la lectura rápida y tolerante a errores por encima de la densidad de información. Esa misma corrección de errores, construida con códigos Reed-Solomon, es lo que permite que un código siga siendo legible aunque una esquina esté rota, manchada o parcialmente cubierta por un logotipo, y también es lo que permite que un decodificador de imágenes recupere un contenido limpio a partir de una foto imperfecta.
Qué tipo de contenido puede devolverse
Un código QR decodificado puede contener mucho más que una URL: texto plano, las credenciales de una red Wi-Fi en formato estructurado, un bloque de contacto vCard, datos de un evento de calendario, o una cadena arbitraria que un sistema interno codificó para sus propios fines. El endpoint devuelve exactamente lo que fue codificado sin asumir un caso de uso particular, dejando la interpretación del contenido al sistema que consuma el resultado.
Cómo encaja en un flujo automatizado de recepción
Los sistemas de recepción de bodega que fotografían tarimas entrantes, las aplicaciones móviles que dejan a un usuario capturar un código en lugar de escribir un enlace, y los flujos de captura de documentos que necesitan extraer datos QR incrustados en formularios escaneados, todos llaman a este endpoint de la misma forma, enviando una imagen y recibiendo el contenido por webhook firmado o por enlace firmado. Los lotes de imágenes escaneadas de una sola jornada de recepción se procesan con el mismo modelo asíncrono, sin ningún manejo especial.
Qué puede hacer con ella
Recepción de bodega a partir de tarimas fotografiadas
Decodifique etiquetas QR de envíos entrantes directamente desde una foto tomada con el celular en el muelle de carga, sin un lector dedicado.
Incorporación en apps móviles mediante código escaneado
Deje que un usuario capture una foto de un código QR para importar credenciales de Wi-Fi o una tarjeta de contacto en lugar de escribirlas a mano.
Captura de documentos con referencias QR incrustadas
Extraiga un identificador interno de seguimiento codificado en un QR impreso sobre un formulario escaneado durante un procesamiento masivo de documentos.
Verificación de códigos impresos antes de un envío
Decodifique un lote de etiquetas QR recién impresas para confirmar que cada una contiene el dato correcto antes de que salga el empaque.
Preguntas frecuentes
¿Qué formatos acepta esta api para leer código qr como imagen?
Se aceptan formatos de imagen ráster comunes que contengan un código QR fotografiado o renderizado; envíe la captura más clara posible para mejores resultados.
¿Puede leer un código QR borroso o en ángulo?
Sí, dentro de lo razonable, el decodificador está construido para tolerar los ángulos y la iluminación imperfectos típicos de una foto de celular, sin exigir un escaneo plano y frontal.
¿Qué pasa si la imagen no tiene ningún código QR?
La tarea lo informa con claridad en lugar de devolver un resultado vacío o engañoso.
¿Puedo decodificar varios códigos QR en una misma imagen?
Sí, cada código encontrado en el cuadro se decodifica y se devuelve por separado, identificado según su posición en la imagen.
¿Esta API me dice qué tipo de dato fue codificado?
Devuelve el contenido decodificado en bruto; si esa cadena representa una URL, credenciales de Wi-Fi o texto plano queda a interpretación de su aplicación.
¿Existe una versión gratuita de este lector?
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 decodificar un código QR?
$0.002 por solicitud más $0.005 por imagen, y no se cobra por una tarea que termina fallando tras los reintentos.
¿Puedo enviar un lote de imágenes escaneadas de una vez?
Sí, los lotes corren de forma asíncrona, así que toda una jornada de recepción puede enviarse junta y procesarse sin bloquear su aplicación.
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
¿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-decode \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"image":"https://ejemplo.com/imagen.jpg"}'const res = await fetch("https://api.kit.forhosting.com/dev/qr-decode", {
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-decode",
headers={"Authorization": f"Bearer {os.environ['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-decode", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"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-decode", 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_decode",
"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
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. |