QivoEstudio de código QR
Creación de código QR

Para la integración

Un código QR en una sola solicitud

Envíe las configuraciones de contenido y diseño a través de GET / POST y reciba un PNG o SVG sin una verificación de escaneo adicional.

Libre y para siempre.PNG, SVG y API - no hay tarifas ni suscripciones.

Los códigos QR. No se reanuda, no expira.

GET / POSThttps://qivo.umind.group/

Solicitud y autenticación

Pasar la llave en el encabezado X-API-Key. no se requieren sesiones de editor y cookies. QIVO_API_KEY en este ejemplo es una variable del entorno del cliente que contiene su llave.

El ejemplo de la curva
curl --fail --show-error --get 'https://qivo.umind.group/' \
  --header "X-API-Key: $QIVO_API_KEY" \
  --data-urlencode 'data=https://umind.group' \
  --data-urlencode 'contentType=url' \
  --data-urlencode 'format=svg' \
  --data-urlencode 'shape=rounded' \
  --data-urlencode 'size=1024' \
  --output qr-code.svg

Si su integración acepta sólo una URL, pasa la llave en el parámetro clave:

Ejemplo de URL
https://qivo.umind.group/?key=YOUR_SECRET_KEY&data=https%3A%2F%2Fumind.group&format=png&size=1024

Substituye YOUR_SECRET_KEY con su clave. El título toma precedencia sobre el parámetro clave. URL-encodado parámetros valores: # → %23, + → %2B, y & dentro de un valor → %26.

Utilice HTTPS y mantenga la clave en su servidor. No la coloque en JavaScript público. Las claves y los datos en las URL de GET pueden aparecer en la historia del navegador o en los logs del servidor; prefiera el título para su clave.

Exemplos de código

Almacenar la llave en la variable del entorno QIVO_API_KEY; no la publique en código de página.

qr-code.php
<?php
$key = getenv('QIVO_API_KEY');
if (!$key) throw new RuntimeException('Set QIVO_API_KEY');
$query = http_build_query([
    'data' => 'https://umind.group', 'format' => 'svg',
    'shape' => 'rounded', 'size' => 1024,
], '', '&', PHP_QUERY_RFC3986);
$curl = curl_init('https://qivo.umind.group/?' . $query);
curl_setopt_array($curl, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['X-API-Key: ' . $key],
    CURLOPT_TIMEOUT => 30,
]);
$image = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_RESPONSE_CODE);
curl_close($curl);
if ($image === false || $status !== 200) {
    throw new RuntimeException('Qivo request failed: ' . $status);
}
file_put_contents('qr-code.svg', $image);
qr-code.mjs
import { writeFile } from 'node:fs/promises';
const key = process.env.QIVO_API_KEY;
if (!key) throw new Error('Set QIVO_API_KEY');
const url = new URL('https://qivo.umind.group/');
url.search = new URLSearchParams({
  data: 'https://umind.group', format: 'svg',
  shape: 'rounded', size: '1024'
});
const response = await fetch(url, {
  headers: { 'X-API-Key': key },
  signal: AbortSignal.timeout(30000)
});
if (!response.ok) throw new Error(`Qivo request failed: ${response.status}`);
await writeFile('qr-code.svg', Buffer.from(await response.arrayBuffer()));
qr-code.py
import os
from pathlib import Path
from urllib.parse import urlencode
from urllib.request import Request, urlopen

key = os.environ['QIVO_API_KEY']
query = urlencode({
    'data': 'https://umind.group', 'format': 'svg',
    'shape': 'rounded', 'size': 1024,
})
request = Request('https://qivo.umind.group/?' + query,
                  headers={'X-API-Key': key})
# urlopen raises HTTPError for unsuccessful HTTP responses.
with urlopen(request, timeout=30) as response:
    Path('qr-code.svg').write_bytes(response.read())

El logotipo upload

POSThttps://qivo.umind.group/

Content-Type: multipart/form-data
X-API-Key: YOUR_SECRET_KEY

Qivo acepta archivos PNG, JPEG y WebP hasta 2 MB, con un lado máximo de 2048 píxeles. no se aceptan las cargas SVG. PNG o WebP con transparencia funciona bien para una marca sin fondo.

ParámetrosTipoRequisitosValores
X-API-KeyheaderNecesidadYOUR_SECRET_KEY
logostringNecesidadupload
logoFilefileNecesidadPNG / JPEG / WebP · ≤ 2 MiB · ≤ 2048 × 2048 px · ≤ 4,000,000 px
logoScaleintegerOpcional12–30 · Definición: 24
logoPaddingintegerOpcional0–25% · Definición: 5

GET → logo=none / whatsapp / …
POST → logo=upload + logoFile
logoUrl / logoBase64 / SVG / GIF → 422
Content-Length > 3 MiB → 413
level → H

cURL · multipart/form-data
curl --fail --show-error 'https://qivo.umind.group/' \
  --header "X-API-Key: $QIVO_API_KEY" \
  --form-string 'data=https://umind.group' \
  --form-string 'format=svg' \
  --form-string 'logo=upload' \
  --form-string 'logoPadding=10' \
  --form-string 'logoScale=24' \
  --form 'logoFile=@./logo.png;type=image/png' \
  --output qr-code.svg
PHP · CURLFile
<?php
$key = getenv('QIVO_API_KEY');
if (!$key) throw new RuntimeException('Set QIVO_API_KEY');
$curl = curl_init('https://qivo.umind.group/');
curl_setopt_array($curl, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['X-API-Key: ' . $key],
    CURLOPT_TIMEOUT => 30,
    CURLOPT_POSTFIELDS => [
        'data' => 'https://umind.group', 'format' => 'png',
        'logo' => 'upload', 'logoScale' => '24', 'logoPadding' => '10',
        'logoFile' => new CURLFile(__DIR__ . '/logo.png', 'image/png', 'logo.png'),
    ],
]);
$image = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_RESPONSE_CODE);
curl_close($curl);
if ($image === false || $status !== 200) throw new RuntimeException('Qivo: ' . $status);
file_put_contents('qr-code.png', $image);
JavaScript · Node.js 20+
import { readFile, writeFile } from 'node:fs/promises';
const key = process.env.QIVO_API_KEY;
if (!key) throw new Error('Set QIVO_API_KEY');
const form = new FormData();
form.set('data', 'https://umind.group');
form.set('format', 'svg');
form.set('logo', 'upload');
form.set('logoPadding', '10');
form.set('logoFile', new Blob([await readFile('./logo.png')], { type: 'image/png' }), 'logo.png');
// FormData supplies Content-Type and the multipart boundary automatically.
const response = await fetch('https://qivo.umind.group/', {
  method: 'POST', headers: { 'X-API-Key': key }, body: form,
  signal: AbortSignal.timeout(30000)
});
if (!response.ok) throw new Error(`Qivo: ${response.status}`);
await writeFile('qr-code.svg', Buffer.from(await response.arrayBuffer()));
Python · requests
# python -m pip install requests
import os
from pathlib import Path
import requests

with open('logo.png', 'rb') as logo:
    response = requests.post(
        'https://qivo.umind.group/',
        headers={'X-API-Key': os.environ['QIVO_API_KEY']},
        data={'data': 'https://umind.group', 'format': 'svg', 'logo': 'upload', 'logoPadding': '10'},
        files={'logoFile': ('logo.png', logo, 'image/png')},
        timeout=30,
    )
response.raise_for_status()
Path('qr-code.svg').write_bytes(response.content)

La geometría QR dentro de un SVG se basa en vectores. su logotipo cargado se incorpora como una imagen de raster limpiada, por lo que su detalle no se vuelve ilimitado. Para un gran poster, inspeccione la agudez del logotipo separadamente.

Parámetros de diseño

ParámetrosTipoRequisitosValores
X-API-Key / keystringNecesidad
clave secreta: header o parámetro GET
datastringTítulo y URL
Contenido requerido para texto/url
contentTypestringOpcional
texturlwifivcardwhatsapptelegramphoneviberemailsms
Definición: text
formatstringOpcional
pngsvg
Definición: png
sizeintegerOpcional
25651210242048
Definición: 1024
shapestringOpcional
squaresoftroundeddotsleaf-softleafhorizontalverticalpointednotchedstardiamondxx-roundedplusplus-roundedheartsparkleconfetti
Definición: square
borderstringOpcional
squarecircleroundedskewdrop-tldrop-brleafleaf-inner-brleaf-circleleaf-inner-tlsquare-circlesoft-tlsoft-brsoft-leafrough
Definición: square
centerstringOpcional
squarecircleroundedskewroughdrop-tldrop-brleafgearstardiamondxx-roundedplusplus-roundedheart
Definición: square
foreground / eyeColorstringOpcional
#RRGGBB
Definición: #192b39
backgroundstringOpcional
#RRGGBB
Definición: #ffffff
levelstringOpcional
LMQH
Definición: M
quietZoneintegerOpcional
0 a 12 módulos
Definición: 4
logostringOpcional
noneuploadwhatsapplinklocationwificredentialemailscanbellmenuscan-mescan-me-v2paypalbitcoinsparkplusdiamond
Definición: none
logoScaleintegerOpcional
12–30
Definición: 24
logoPaddingintegerOpcional
0–25%
Definición: 5

logo=upload → POST / · logoFile · level=H

Tipos de contenidos

Los campos dependen del contenidoType.Para las URLs, proporcione una dirección completa https:// o http://.Para los números de teléfono, incluye el código del país.

contentTypeLos campos necesariosLos campos opcionales
text / urldata—
phone / viberphone—
whatsapp / smsphonemessage
telegramtelegram—
emailemailsubject, message
wifissid; wifiSecurity≠nopass → wifiPasswordwifiSecurity (WPA), wifiHidden (0)
vcardfirstName / lastNameorganization, jobTitle, phone, email, website, address
Exemplos telefónicos
https://qivo.umind.group/?key=YOUR_SECRET_KEY&contentType=phone&phone=%2B380671234567&format=svg

Respuestas de fuego

Una respuesta exitosa es el propio archivo de imagen, sin un engranaje JSON.Type de contenido es imagen/png o imagen/svg+xml. Los errores se devuelven como JSON:

JSON
{"error":"Invalid API key."}
  • 200 — La imagen generada.
  • 401 — La clave ausente o invalida.
  • 405 — GET / POST
  • 413 — Content-Length > 3 MiB
  • 415 — POST: multipart/form-data
  • 422 — Parámetros invalidos o contenido ausente.
  • 429 — El límite de tasa superado; Retiro-Después: 60.
  • 503 — El acceso a API no está configurado o la protección no está temporalmente disponible.
  • 500 — Errores de generación interna.

Límites y validación

El límite de default es 60 solicitudes por minuto por IP. El contenido codificado está limitado a 800 bytes. la salida PNG soporta hasta 2048 × 2048 px. SVG conserva las formas vectoras.

La API valida los formatos de parámetros, el tamaño y el contraste, pero no ejecuta un decodificador o verifica si los QR escanean.

Obtener acceso

La API es gratuita y siempre permanecerá gratuita. Complete el formulario corto para solicitar una llave secreta.

Los detalles del formulario se enviarán al equipo de Qivo para revisar su solicitud y respuesta.