Qivopracownia kodów QR
Utwórz kod QR

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.

Przykład curl
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

Jeśli integracja przyjmuje tylko URL, przekaż klucz w parametrze key:

Przykład adresu GET
https://qivo.umind.group/?key=YOUR_SECRET_KEY&data=https%3A%2F%2Fumind.group&format=png&size=1024

Zastą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.

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

Logotyp upload

POSThttps://qivo.umind.group/

Content-Type: multipart/form-data
X-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.

ParametrTypwymógWartości
X-API-KeyheaderPotrzebneYOUR_SECRET_KEY
logostringPotrzebneupload
logoFilefilePotrzebnePNG / JPEG / WebP · ≤ 2 MiB · ≤ 2048 × 2048 px · ≤ 4,000,000 px
logoScaleintegerOpcjonalne12–30 · Domyślnie: 24
logoPaddingintegerOpcjonalne0–25% · Domyślnie: 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)

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

ParametrTypwymógWartości
X-API-Key / keystringPotrzebne
Sekretny klucz: nagłówek lub parametr GET
datastringTekst i url
Wymagana treść dla text/url
contentTypestringOpcjonalne
texturlwifivcardwhatsapptelegramphoneviberemailsms
Domyślnie: text
formatstringOpcjonalne
pngsvg
Domyślnie: png
sizeintegerOpcjonalne
25651210242048
Domyślnie: 1024
shapestringOpcjonalne
squaresoftroundeddotsleaf-softleafhorizontalverticalpointednotchedstardiamondxx-roundedplusplus-roundedheartsparkleconfetti
Domyślnie: square
borderstringOpcjonalne
squarecircleroundedskewdrop-tldrop-brleafleaf-inner-brleaf-circleleaf-inner-tlsquare-circlesoft-tlsoft-brsoft-leafrough
Domyślnie: square
centerstringOpcjonalne
squarecircleroundedskewroughdrop-tldrop-brleafgearstardiamondxx-roundedplusplus-roundedheart
Domyślnie: square
foreground / eyeColorstringOpcjonalne
#RRGGBB
Domyślnie: #192b39
backgroundstringOpcjonalne
#RRGGBB
Domyślnie: #ffffff
levelstringOpcjonalne
LMQH
Domyślnie: M
quietZoneintegerOpcjonalne
0–12 modułów
Domyślnie: 4
logostringOpcjonalne
noneuploadwhatsapplinklocationwificredentialemailscanbellmenuscan-mescan-me-v2paypalbitcoinsparkplusdiamond
Domyślnie: none
logoScaleintegerOpcjonalne
12–30
Domyślnie: 24
logoPaddingintegerOpcjonalne
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.

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

Odpowiedzi API

Poprawna odpowiedź to plik obrazu, bez JSON. Content-Type: image/png lub image/svg+xml. Błędy są zwracane jako JSON:

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.

Uzyskaj dostęp

API jest darmowe i zawsze pozostanie darmowe. wypełnij krótki formularz, aby poprosić o tajny klucz.

Wszystkie trzy pola są wymagane. szczegóły formularza zostaną wysłane do zespołu Qivo, aby przeglądać Twoje żądanie i odpowiedzieć.