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.
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.svgSi su integración acepta sólo una URL, pasa la llave en el parámetro clave:
https://qivo.umind.group/?key=YOUR_SECRET_KEY&data=https%3A%2F%2Fumind.group&format=png&size=1024Substituye 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.
<?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);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()));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-dataX-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ámetros | Tipo | Requisitos | Valores |
|---|---|---|---|
X-API-Key | header | Necesidad | YOUR_SECRET_KEY |
logo | string | Necesidad | upload |
logoFile | file | Necesidad | PNG / JPEG / WebP · ≤ 2 MiB · ≤ 2048 × 2048 px · ≤ 4,000,000 px |
logoScale | integer | Opcional | 12–30 · Definición: 24 |
logoPadding | integer | Opcional | 0–25% · Definición: 5 |
GET → logo=none / whatsapp / …POST → logo=upload + logoFilelogoUrl / logoBase64 / SVG / GIF → 422Content-Length > 3 MiB → 413level → H
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
$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);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 -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ámetros | Tipo | Requisitos | Valores |
|---|---|---|---|
X-API-Key / key | string | Necesidad | clave secreta: header o parámetro GET |
data | string | Título y URL | Contenido requerido para texto/url |
contentType | string | Opcional | texturlwifivcardwhatsapptelegramphoneviberemailsmsDefinición: text |
format | string | Opcional | pngsvgDefinición: png |
size | integer | Opcional | 25651210242048Definición: 1024 |
shape | string | Opcional | squaresoftroundeddotsleaf-softleafhorizontalverticalpointednotchedstardiamondxx-roundedplusplus-roundedheartsparkleconfettiDefinición: square |
border | string | Opcional | squarecircleroundedskewdrop-tldrop-brleafleaf-inner-brleaf-circleleaf-inner-tlsquare-circlesoft-tlsoft-brsoft-leafroughDefinición: square |
center | string | Opcional | squarecircleroundedskewroughdrop-tldrop-brleafgearstardiamondxx-roundedplusplus-roundedheartDefinición: square |
foreground / eyeColor | string | Opcional | #RRGGBB Definición: #192b39 |
background | string | Opcional | #RRGGBB Definición: #ffffff |
level | string | Opcional | LMQHDefinición: M |
quietZone | integer | Opcional | 0 a 12 módulos Definición: 4 |
logo | string | Opcional | noneuploadwhatsapplinklocationwificredentialemailscanbellmenuscan-mescan-me-v2paypalbitcoinsparkplusdiamondDefinición: none |
logoScale | integer | Opcional | 12–30 Definición: 24 |
logoPadding | integer | Opcional | 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.
| contentType | Los campos necesarios | Los campos opcionales |
|---|---|---|
| text / url | data | — |
| phone / viber | phone | — |
| whatsapp / sms | phone | message |
| telegram | telegram | — |
| subject, message | ||
| wifi | ssid; wifiSecurity≠nopass → wifiPassword | wifiSecurity (WPA), wifiHidden (0) |
| vcard | firstName / lastName | organization, jobTitle, phone, email, website, address |
https://qivo.umind.group/?key=YOUR_SECRET_KEY&contentType=phone&phone=%2B380671234567&format=svgRespuestas 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:
{"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.