QivoQR-Code-Werkstatt
QR-Code erstellen

Für Integrationen

QR-Code mit einer Anfrage

QR-Code-Generierung in deinen Dienst integrieren. Inhalt und Design per GET / POST senden und PNG oder SVG ohne zusätzliche Leseprüfung erhalten.

Kostenlos. Für immer.PNG, SVG und API — ohne Gebühren oder Abos.

Direkte QR-Codes. Keine Weiterleitungen. Kein Ablaufdatum.

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

Anfrage und Authentifizierung

Schlüssel im Header X-API-Key senden. Editor-Sitzung und Cookies sind nicht nötig. QIVO_API_KEY ist im Beispiel eine Umgebungsvariable des Clients mit deinem Schlüssel.

curl-Beispiel
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

Wenn die Integration nur URLs akzeptiert, den Schlüssel als Parameter key senden:

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

YOUR_SECRET_KEY durch deinen Schlüssel ersetzen. Der Header hat Vorrang. URL-Werte codieren: # → %23, + → %2B, & innerhalb eines Werts → %26.

HTTPS verwenden und den Schlüssel auf dem Server aufbewahren, nicht in öffentlichem JavaScript. URL-Daten können in Verlauf und Logs landen; den Schlüssel bevorzugt im Header senden.

Code Beispiele

Speichern Sie den Schlüssel in der QIVO_API_KEY Umgebung Variable; veröffentlichen Sie ihn nicht in Seitencode.

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

Logo hochladen

POSThttps://qivo.umind.group/

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

Qivo akzeptiert PNG, JPEG und WebP-Dateien bis zu 2 MB, mit einer maximalen Seite von 2048 Pixeln. SVG-Uploads werden nicht akzeptiert. PNG oder WebP mit Transparenz funktioniert gut für eine Marke ohne Hintergrund.

ParameterTypAnforderungWerte
X-API-KeyheadererforderlichYOUR_SECRET_KEY
logostringerforderlichupload
logoFilefileerforderlichPNG / JPEG / WebP · ≤ 2 MiB · ≤ 2048 × 2048 px · ≤ 4,000,000 px
logoScaleintegerOptional12–30 · Standard: 24
logoPaddingintegerOptional0–25% · Standard: 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)

Die QR-Geometrie innerhalb eines SVG ist vektorbasiert. Ihr hochgeladenes Logo ist als sauberes Rasterbild eingebettet, so dass sein Detail nicht unbegrenzt wird. Für einen großen Plakat überprüfen Sie die Genauigkeit des Logos separat.

Designparameter

ParameterTypAnforderungWerte
X-API-Key / keystringerforderlich
Geheimschlüssel: Header oder GET-Parameter
datastringText und URL
Erforderlicher Inhalt für text/url
contentTypestringOptional
texturlwifivcardwhatsapptelegramphoneviberemailsms
Standard: text
formatstringOptional
pngsvg
Standard: png
sizeintegerOptional
25651210242048
Standard: 1024
shapestringOptional
squaresoftroundeddotsleaf-softleafhorizontalverticalpointednotchedstardiamondxx-roundedplusplus-roundedheartsparkleconfetti
Standard: square
borderstringOptional
squarecircleroundedskewdrop-tldrop-brleafleaf-inner-brleaf-circleleaf-inner-tlsquare-circlesoft-tlsoft-brsoft-leafrough
Standard: square
centerstringOptional
squarecircleroundedskewroughdrop-tldrop-brleafgearstardiamondxx-roundedplusplus-roundedheart
Standard: square
foreground / eyeColorstringOptional
#RRGGBB
Standard: #192b39
backgroundstringOptional
#RRGGBB
Standard: #ffffff
levelstringOptional
LMQH
Standard: M
quietZoneintegerOptional
0–12 Module
Standard: 4
logostringOptional
noneuploadwhatsapplinklocationwificredentialemailscanbellmenuscan-mescan-me-v2paypalbitcoinsparkplusdiamond
Standard: none
logoScaleintegerOptional
12–30
Standard: 24
logoPaddingintegerOptional
0–25%
Standard: 5

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

Inhaltstypen

Die Felder hängen von contentType ab. URLs vollständig mit https:// oder http:// und Telefonnummern mit Landesvorwahl angeben.

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

API-Antworten

Eine erfolgreiche Antwort ist die Bilddatei ohne JSON-Hülle. Content-Type: image/png oder image/svg+xml. Fehler werden als JSON ausgegeben:

JSON
{"error":"Invalid API key."}
  • 200 — Bild erzeugt.
  • 401 — Schlüssel fehlt oder ist ungültig.
  • 405 — GET / POST
  • 413 — Content-Length > 3 MiB
  • 415 — POST: multipart/form-data
  • 422 — Ungültige Parameter oder fehlender Inhalt.
  • 429 — Limit überschritten; Retry-After: 60.
  • 503 — API nicht eingerichtet oder Schutz vorübergehend nicht verfügbar.
  • 500 — Interner Generierungsfehler.

Limits und Validierung

Standardmäßig 60 Anfragen pro Minute und IP, maximal 800 Bytes codierter Inhalt und PNG bis 2048 × 2048 px. SVG bewahrt Vektorformen.

Die API prüft Parameter, Größe und Kontrast, führt aber keinen Decoder aus. Dekorative Designs und Drucke mit der Kamera testen.

Zugang erhalten

Die API ist kostenlos und bleibt immer frei.Füllen Sie das kurze Formular, um einen geheimen Schlüssel zu beantragen.

Alle drei Felder sind erforderlich. Die Formulardaten werden an das Qivo-Team geschickt, um Ihre Anfrage und Antwort zu überprüfen.