QivoQR code studio
Creëren van QR code

Voor integratie

Een QR-code in één verzoek

Stuur inhoud en ontwerpinstellingen via GET / POST en ontvang een PNG of SVG zonder extra scancheck.

Vrij en voor altijd.PNG, SVG en API – geen kosten of abonnementen.

Direct QR codes. Geen redirect, geen beëindiging.

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

Verzoek en authenticatie

Geef uw sleutel in de X-API-Key header. Editor sessies en cookies zijn niet vereist. QIVO_API_KEY in dit voorbeeld is een cliëntomgeving variabele die uw sleutel bevat.

Curl voorbeeld
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

Als uw integratie slechts een URL accepteert, ga dan de sleutel in de sleutelparameters door:

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

Vervang YOUR_SECRET_KEY met uw sleutel. de header neemt voorrang over de sleutelparameters. URL-encode parameter waarden: # → %23, + → %2B, en & binnen een waarde → %26.

Gebruik HTTPS en houd de sleutel op uw server. Laat het niet in openbaar JavaScript. Keys en gegevens in GET URL's kunnen verschijnen in de browsergeschiedenis of serverlogs; voorziet de header voor uw sleutel.

Code voorbeelden

Speel de sleutel in de QIVO_API_KEY omgeving variabele; publiceer het niet in pagina-code.

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())

Logotip upload

POSThttps://qivo.umind.group/

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

Qivo accepteert PNG, JPEG en WebP bestanden tot 2 MB, met een maximale kant van 2048 pixels. SVG-opdrachten zijn niet geaccepteerd. PNG of WebP met transparantie werkt goed voor een merk zonder achtergrond.

ParametersTypeVerplichtingwaarden
X-API-KeyheadervereistYOUR_SECRET_KEY
logostringvereistupload
logoFilefilevereistPNG / JPEG / WebP · ≤ 2 MiB · ≤ 2048 × 2048 px · ≤ 4,000,000 px
logoScaleintegerOptieel12–30 · Default: 24
logoPaddingintegerOptieel0–25% · Default: 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)

De QR-geometrie binnen een SVG is vectorgebaseerd. uw geüpload logo wordt ingebed als een gereinigde raster beeld, dus de details worden niet onbeperkt.

Ontwerpparameters

ParametersTypeVerplichtingwaarden
X-API-Key / keystringvereist
Geheime sleutel: header of GET parameter
datastringVoor tekst en url
Beperkte inhoud voor tekst/url
contentTypestringOptieel
texturlwifivcardwhatsapptelegramphoneviberemailsms
Default: text
formatstringOptieel
pngsvg
Default: png
sizeintegerOptieel
25651210242048
Default: 1024
shapestringOptieel
squaresoftroundeddotsleaf-softleafhorizontalverticalpointednotchedstardiamondxx-roundedplusplus-roundedheartsparkleconfetti
Default: square
borderstringOptieel
squarecircleroundedskewdrop-tldrop-brleafleaf-inner-brleaf-circleleaf-inner-tlsquare-circlesoft-tlsoft-brsoft-leafrough
Default: square
centerstringOptieel
squarecircleroundedskewroughdrop-tldrop-brleafgearstardiamondxx-roundedplusplus-roundedheart
Default: square
foreground / eyeColorstringOptieel
#RRGGBB
Default: #192b39
backgroundstringOptieel
#RRGGBB
Default: #ffffff
levelstringOptieel
LMQH
Default: M
quietZoneintegerOptieel
0 - 12 modules
Default: 4
logostringOptieel
noneuploadwhatsapplinklocationwificredentialemailscanbellmenuscan-mescan-me-v2paypalbitcoinsparkplusdiamond
Default: none
logoScaleintegerOptieel
12–30
Default: 24
logoPaddingintegerOptieel
0–25%
Default: 5

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

Inhoudstypen

De velden zijn afhankelijk van contentType. voor URL's, een volledige https:// of http:// adres. voor telefoonnummers, de landcode.

contentTypeVerplichte veldenOptionele velden
text / urldata—
phone / viberphone—
whatsapp / smsphonemessage
telegramtelegram—
emailemailsubject, message
wifissid; wifiSecurity≠nopass → wifiPasswordwifiSecurity (WPA), wifiHidden (0)
vcardfirstName / lastNameorganization, jobTitle, phone, email, website, address
Telefoon voorbeeld
https://qivo.umind.group/?key=YOUR_SECRET_KEY&contentType=phone&phone=%2B380671234567&format=svg

Vuur reacties

Een succesvolle reactie is het beeldbestand zelf, zonder een JSON-verwijder. Content-Type is image/png of image/svg+xml.

JSON
{"error":"Invalid API key."}
  • 200 — De afbeelding wordt gegenereerd.
  • 401 — Vermijd of ongeldig sleutel.
  • 405 — GET / POST
  • 413 — Content-Length > 3 MiB
  • 415 — POST: multipart/form-data
  • 422 — Invalide parameters of ontbrekende inhoud.
  • 429 — Rate limit overschreden; Retry-After: 60.
  • 503 — API-toegang is niet geconfigureerd of bescherming is tijdelijk niet beschikbaar.
  • 500 — Een interne generatiefout.

Limieten en validatie

De standaardgrens is 60 verzoeken per minuut per IP. Encoded content is beperkt tot 800 byten. PNG output ondersteunt tot 2048 × 2048 px. SVG behoudt vectorvormingen.

De API valideren parametersformaat, grootte en contrast, maar werkt niet met een decoder of controleert of de QR scans.

toegang krijgen

De API is gratis en blijft altijd gratis.Vul het korte formulier om een geheime sleutel te vragen.

Alle drie velden zijn vereist.De formuliergegevens worden naar het Qivo-team gestuurd om uw verzoek en antwoord te beoordelen.