Guías Prácticas de Qivo
Cómo funciona una API de generación de código QR
Una API le permite generar códigos QR automáticamente de su sitio web, herramienta interna o script.
Su aplicación envía contenido y configuraciones; Qivo devuelve una imagen QR estática.
De un editor manual a una integración
Con una API, un programa realiza estas acciones, por ejemplo, generando un código QR de una página de producto mientras prepara un etiquetado.
Una llamada de API no hace dinámica el código. la imagen almacena los datos enviados en lugar de una URL Qivo intermedia. Puede guardar y utilizar el archivo sin ponerse en contacto con el generador de nuevo.
Lo que una solicitud contiene
Un pedido GET contiene la dirección de servicio, los parámetros y una clave secreta. El contenidoType parámetro selecciona el tipo de datos, formato selecciona PNG o SVG, y forma, frontera y centro controlan el diseño.
Los valores de los parámetros deben ser codificados por URL. Utilice las herramientas estándar de su lenguaje para gestionar correctamente los espacios, los + en los números de teléfono y los # en los colores. Los campos necesarios invalidos o faltantes causan una respuesta de error.
Por qué la clave pertenece a su servidor
Los visitantes pueden leer una clave colocada en JavaScript de una página pública.Enviar solicitudes desde su servidor y cargar la clave de una variable ambiental.
Envíe la clave en el encabezado de la clave X-API a través de HTTPS. El parámetro de URL clave también se apoya, pero las URL pueden aparecer en la historia y los registros. Nunca coloque su clave secreta en la imagen QR o ejemplos públicos.
Cómo gestionar la respuesta
Una respuesta exitosa contiene la imagen misma, no JSON con un enlace de descarga. Verifique el estado de HTTP antes de ahorrar. Errores devuelven a JSON con una explicación; no ahorrarlo como un PNG.
SVG es útil para los materiales impresos, mientras que PNG se ajusta a las imágenes diarias. Evite regenerar un código en cada visita a una página inalterada: guardar y reutilizar el archivo. Respetar los límites de solicitud y retrasar.
Qué comprobar antes de publicar
La API valida la entrada pero no decodifica la imagen terminada. Esto reduce el procesamiento, pero su flujo de trabajo debe manejar las pruebas de escaneo.
Deja una zona tranquila de al menos cuatro módulos, buen contraste y tamaño suficiente. Escanear el diseño impreso final con un teléfono. La página API contiene parámetros técnicos y ejemplos de PHP, JavaScript, Python y cURL listos para uso.
Fuentes y Leer más
Preparado y mantenido por Umind. prueba estas recomendaciones en su diseño final y dispositivos de destino.