Do integracji
Kod QR w jednym żądaniu
Dodaj generowanie kodów do swojej usługi. Prześlij treść i ustawienia przez GET / POST, aby otrzymać PNG lub SVG bez kontroli odczytu.
Bezpłatnie. Na zawsze.PNG, SVG i API — bez opłat i subskrypcji.
Bezpośrednie kody QR. Bez przekierowań i daty ważności.
GET / POSThttps://qivo.umind.group/
Żądanie i autoryzacja
Przekaż klucz w nagłówku X-API-Key. Sesja i cookie edytora nie są potrzebne. QIVO_API_KEY w przykładzie to zmienna środowiskowa klienta zawierająca klucz.
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.svgJeśli integracja przyjmuje tylko URL, przekaż klucz w parametrze key:
https://qivo.umind.group/?key=YOUR_SECRET_KEY&data=https%3A%2F%2Fumind.group&format=png&size=1024Zastąp YOUR_SECRET_KEY swoim kluczem. Nagłówek ma pierwszeństwo. Koduj wartości URL: # → %23, + → %2B, & wewnątrz wartości → %26.
Używaj HTTPS i przechowuj klucz na serwerze, nie w publicznym JavaScript. Dane i klucz w URL mogą trafić do historii lub logów; dla klucza preferuj nagłówek.
Przykłady kodów
Zapisz klucz w zmiennej środowiska QIVO_API_KEY; nie publikuj go w kodzie strony.
<?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())Logotyp upload
POSThttps://qivo.umind.group/
Content-Type: multipart/form-dataX-API-Key: YOUR_SECRET_KEY
Qivo akceptuje pliki PNG, JPEG i WebP do 2 MB, z maksymalną stroną 2048 pikseli. przesyłki SVG nie są akceptowane.
| Parametr | Typ | wymóg | Wartości |
|---|---|---|---|
X-API-Key | header | Potrzebne | YOUR_SECRET_KEY |
logo | string | Potrzebne | upload |
logoFile | file | Potrzebne | PNG / JPEG / WebP · ≤ 2 MiB · ≤ 2048 × 2048 px · ≤ 4,000,000 px |
logoScale | integer | Opcjonalne | 12–30 · Domyślnie: 24 |
logoPadding | integer | Opcjonalne | 0–25% · Domyślnie: 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)Geometria QR wewnątrz SVG jest oparta na wektorze. Twoje przesyłane logo jest wbudowane jako czyste obraz raster, więc jego szczegóły nie stają się nieograniczone. Dla dużego plakatu sprawdź ostrość logo oddzielnie.
Parametry wyglądu
| Parametr | Typ | wymóg | Wartości |
|---|---|---|---|
X-API-Key / key | string | Potrzebne | Sekretny klucz: nagłówek lub parametr GET |
data | string | Tekst i url | Wymagana treść dla text/url |
contentType | string | Opcjonalne | texturlwifivcardwhatsapptelegramphoneviberemailsmsDomyślnie: text |
format | string | Opcjonalne | pngsvgDomyślnie: png |
size | integer | Opcjonalne | 25651210242048Domyślnie: 1024 |
shape | string | Opcjonalne | squaresoftroundeddotsleaf-softleafhorizontalverticalpointednotchedstardiamondxx-roundedplusplus-roundedheartsparkleconfettiDomyślnie: square |
border | string | Opcjonalne | squarecircleroundedskewdrop-tldrop-brleafleaf-inner-brleaf-circleleaf-inner-tlsquare-circlesoft-tlsoft-brsoft-leafroughDomyślnie: square |
center | string | Opcjonalne | squarecircleroundedskewroughdrop-tldrop-brleafgearstardiamondxx-roundedplusplus-roundedheartDomyślnie: square |
foreground / eyeColor | string | Opcjonalne | #RRGGBB Domyślnie: #192b39 |
background | string | Opcjonalne | #RRGGBB Domyślnie: #ffffff |
level | string | Opcjonalne | LMQHDomyślnie: M |
quietZone | integer | Opcjonalne | 0–12 modułów Domyślnie: 4 |
logo | string | Opcjonalne | noneuploadwhatsapplinklocationwificredentialemailscanbellmenuscan-mescan-me-v2paypalbitcoinsparkplusdiamondDomyślnie: none |
logoScale | integer | Opcjonalne | 12–30 Domyślnie: 24 |
logoPadding | integer | Opcjonalne | 0–25% Domyślnie: 5 |
logo=upload → POST / · logoFile · level=H
Typy treści
Pola zależą od contentType. Dla URL podaj pełny adres https:// lub http://, a dla telefonu kod kraju.
| contentType | Potrzebne pola | Opcjonalne pola |
|---|---|---|
| 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=svgOdpowiedzi API
Poprawna odpowiedź to plik obrazu, bez JSON. Content-Type: image/png lub image/svg+xml. Błędy są zwracane jako JSON:
{"error":"Invalid API key."}- 200 — Obraz wygenerowany.
- 401 — Brak klucza lub nieprawidłowy klucz.
- 405 — GET / POST
- 413 — Content-Length > 3 MiB
- 415 — POST: multipart/form-data
- 422 — Nieprawidłowe parametry lub brak treści.
- 429 — Przekroczony limit; Retry-After: 60.
- 503 — API nie jest skonfigurowane lub ochrona jest chwilowo niedostępna.
- 500 — Wewnętrzny błąd generacji.
Limity i walidacja
Standardowo 60 żądań na minutę na IP. Treść po zakodowaniu: do 800 bajtów. PNG do 2048 × 2048 px. SVG zachowuje kształty wektorowe.
API sprawdza parametry, rozmiar i kontrast, ale nie uruchamia dekodera. Ozdobne projekty i wydruki sprawdź aparatem.