Za integracijo
QR kodo v enem zahtevku
Dodajte generacijo kod QR v vašo storitev. pošljite nastavitve vsebine in zasnove prek GET / POST in prejmete PNG ali SVG brez dodatnega skeniranja.
Brezplačno za vedno.PNG, SVG in API – brez pristojbin ali naročnin.
neposredni QR kodo. Brez preusmeritev, brez izteka.
GET / POSThttps://qivo.umind.group/
Zahtevek in preverjanje
V naslovu X-API-Key prikaži svoj ključ. seje za urejanje in piškotki niso potrebni. QIVO_API_KEY v tem primeru je spremenljiva okolja za stranke, ki vsebuje vaš ključ.
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Če vaša integracija sprejme le eno URL, premaknite ključ v ključni parameter:
https://qivo.umind.group/?key=YOUR_SECRET_KEY&data=https%3A%2F%2Fumind.group&format=png&size=1024Naslov prevzema prednost nad ključnim parametrom. URL-kode parametri vrednosti: # → %23, + → %2B, in & v vrednosti → %26.
Uporabite HTTPS in shranite ključ na strežniku. ne postavljajte ga v javni JavaScript. ključi in podatki v URL-jih GET se lahko pojavijo v zgodovini brskalnika ali v dnevnikih strežnika; raje naslov za vaš ključ.
Kodeks primeri
Shrani ključ v QIVO_API_KEY okoljski spremenljivek; ne objavljajte ga v kodo strani.
<?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())Logotip za upload
POSThttps://qivo.umind.group/
Content-Type: multipart/form-dataX-API-Key: YOUR_SECRET_KEY
Qivo sprejema datoteke PNG, JPEG in WebP do 2 MB, z največjo stranjo 2048 slik. SVG naložbe niso sprejete.
| Parametri | Vrsta | zahtevo | vrednosti |
|---|---|---|---|
X-API-Key | header | Potrebno | YOUR_SECRET_KEY |
logo | string | Potrebno | upload |
logoFile | file | Potrebno | PNG / JPEG / WebP · ≤ 2 MiB · ≤ 2048 × 2048 px · ≤ 4,000,000 px |
logoScale | integer | Opcionalno | 12–30 · privzeto: 24 |
logoPadding | integer | Opcionalno | 0–25% · privzeto: 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)QR geometrija znotraj SVG je na podlagi vektorja. vaš naloženi logotip je vgrajen kot očiščen raster sliko, zato njegovi podrobnosti ne postanejo neomejeni. Za velik poster, preverite ostro logo ločeno.
Parametri oblikovanja
| Parametri | Vrsta | zahtevo | vrednosti |
|---|---|---|---|
X-API-Key / key | string | Potrebno | Skrivnostni ključ: naslov ali parameter GET |
data | string | Za besedilo in url | Zahtevana vsebina za besedilo / URL |
contentType | string | Opcionalno | texturlwifivcardwhatsapptelegramphoneviberemailsmsprivzeto: text |
format | string | Opcionalno | pngsvgprivzeto: png |
size | integer | Opcionalno | 25651210242048privzeto: 1024 |
shape | string | Opcionalno | squaresoftroundeddotsleaf-softleafhorizontalverticalpointednotchedstardiamondxx-roundedplusplus-roundedheartsparkleconfettiprivzeto: square |
border | string | Opcionalno | squarecircleroundedskewdrop-tldrop-brleafleaf-inner-brleaf-circleleaf-inner-tlsquare-circlesoft-tlsoft-brsoft-leafroughprivzeto: square |
center | string | Opcionalno | squarecircleroundedskewroughdrop-tldrop-brleafgearstardiamondxx-roundedplusplus-roundedheartprivzeto: square |
foreground / eyeColor | string | Opcionalno | #RRGGBB privzeto: #192b39 |
background | string | Opcionalno | #RRGGBB privzeto: #ffffff |
level | string | Opcionalno | LMQHprivzeto: M |
quietZone | integer | Opcionalno | Od 0 do 12 modulov privzeto: 4 |
logo | string | Opcionalno | noneuploadwhatsapplinklocationwificredentialemailscanbellmenuscan-mescan-me-v2paypalbitcoinsparkplusdiamondprivzeto: none |
logoScale | integer | Opcionalno | 12–30 privzeto: 24 |
logoPadding | integer | Opcionalno | 0–25% privzeto: 5 |
logo=upload → POST / · logoFile · level=H
Vrste vsebine
Polja so odvisna od vsebineType. za URL-je, zagotovite celoten https:// ali http:// naslov. za telefonske številke, vključite kodo države.
| contentType | Potrebna polja | Izbirna polja |
|---|---|---|
| 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=svgOdgovori na ogenj
Uspešen odziv je datoteka slike sama, brez JSON vrzeli. vsebinski tip je slika/png ali slika/svg+xml. napake se vrnejo kot JSON:
{"error":"Invalid API key."}- 200 — Slika je ustvarjena.
- 401 — Izgubljeni ali invalidni ključ.
- 405 — GET / POST
- 413 — Content-Length > 3 MiB
- 415 — POST: multipart/form-data
- 422 — Nepravilni parametri ali manjkajoča vsebina.
- 429 — Stopnja je presegla; Retry-After: 60.
- 503 — API dostop ni konfiguriran ali zaščita je začasno nedostopna.
- 500 — Napaka v notranji generaciji.
Omejitve in validacija
Privzeto omejitev je 60 zahtev na minuto na IP. Šifrirana vsebina je omejena na 800 bajtov. PNG izhod podpira do 2048 × 2048 px. SVG ohranja vektorske oblike.
API potrjuje obliko parametrov, velikost in kontrast, vendar ne izvaja dekodera ali preverja, ali QR skenira.