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 --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.svgWenn die Integration nur URLs akzeptiert, den Schlüssel als Parameter key senden:
https://qivo.umind.group/?key=YOUR_SECRET_KEY&data=https%3A%2F%2Fumind.group&format=png&size=1024YOUR_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.
<?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())Logo hochladen
POSThttps://qivo.umind.group/
Content-Type: multipart/form-dataX-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.
| Parameter | Typ | Anforderung | Werte |
|---|---|---|---|
X-API-Key | header | erforderlich | YOUR_SECRET_KEY |
logo | string | erforderlich | upload |
logoFile | file | erforderlich | PNG / JPEG / WebP · ≤ 2 MiB · ≤ 2048 × 2048 px · ≤ 4,000,000 px |
logoScale | integer | Optional | 12–30 · Standard: 24 |
logoPadding | integer | Optional | 0–25% · Standard: 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)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
| Parameter | Typ | Anforderung | Werte |
|---|---|---|---|
X-API-Key / key | string | erforderlich | Geheimschlüssel: Header oder GET-Parameter |
data | string | Text und URL | Erforderlicher Inhalt für text/url |
contentType | string | Optional | texturlwifivcardwhatsapptelegramphoneviberemailsmsStandard: text |
format | string | Optional | pngsvgStandard: png |
size | integer | Optional | 25651210242048Standard: 1024 |
shape | string | Optional | squaresoftroundeddotsleaf-softleafhorizontalverticalpointednotchedstardiamondxx-roundedplusplus-roundedheartsparkleconfettiStandard: square |
border | string | Optional | squarecircleroundedskewdrop-tldrop-brleafleaf-inner-brleaf-circleleaf-inner-tlsquare-circlesoft-tlsoft-brsoft-leafroughStandard: square |
center | string | Optional | squarecircleroundedskewroughdrop-tldrop-brleafgearstardiamondxx-roundedplusplus-roundedheartStandard: square |
foreground / eyeColor | string | Optional | #RRGGBB Standard: #192b39 |
background | string | Optional | #RRGGBB Standard: #ffffff |
level | string | Optional | LMQHStandard: M |
quietZone | integer | Optional | 0–12 Module Standard: 4 |
logo | string | Optional | noneuploadwhatsapplinklocationwificredentialemailscanbellmenuscan-mescan-me-v2paypalbitcoinsparkplusdiamondStandard: none |
logoScale | integer | Optional | 12–30 Standard: 24 |
logoPadding | integer | Optional | 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.
| contentType | erforderliche Felder | Optionelle Felder |
|---|---|---|
| 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=svgAPI-Antworten
Eine erfolgreiche Antwort ist die Bilddatei ohne JSON-Hülle. Content-Type: image/png oder image/svg+xml. Fehler werden als JSON ausgegeben:
{"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.