untuk integrasi
Kod QR dalam satu permintaan
Hantar kandungan dan tetapan reka bentuk melalui GET / POST dan menerima PNG atau SVG tanpa pemeriksaan pemindaian tambahan.
Percuma dan selamanyaPNG, SVG dan API - tiada yuran atau langganan.
Kod QR secara langsung. Tiada pengubahsuaian. tiada tamat tempoh.
GET / POSThttps://qivo.umind.group/
Permintaan dan pengesahan
Masukkan kunci anda ke dalam tajuk kunci X-API. sesi editor dan kuki tidak diperlukan. QIVO_API_KEY dalam contoh ini ialah variabel persekitaran klien yang mengandungi kunci anda.
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.svgJika integrasi anda hanya menerima URL, masukkan kunci dalam parameter kunci:
https://qivo.umind.group/?key=YOUR_SECRET_KEY&data=https%3A%2F%2Fumind.group&format=png&size=1024Menggantikan YOUR_SECRET_KEY dengan kunci anda. tajuk mengambil keutamaan di atas parameter kunci. nilai parameter kod URL: # → %23, + → %2B, dan & dalam nilai → %26.
Gunakan HTTPS dan simpan kunci pada pelayan anda.Jangan letakkan ia dalam JavaScript awam.Kunci dan data dalam URL GET mungkin muncul dalam sejarah pelayar atau log pelayan; lebih suka tajuk untuk kunci anda.
Contoh Kod
Simpan kunci dalam variabel persekitaran QIVO_API_KEY; jangan menerbitkannya dalam kod halaman.
<?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())Tag: logo upload
POSThttps://qivo.umind.group/
Content-Type: multipart/form-dataX-API-Key: YOUR_SECRET_KEY
Qivo menerima fail PNG, JPEG dan WebP sehingga 2 MB, dengan sisi maksimum 2048 piksel. upload SVG tidak diterima. PNG atau WebP dengan ketelusan berfungsi dengan baik untuk tanda tanpa latar belakang.
| parameter | Jenis | Keperluan | nilai-nilai |
|---|---|---|---|
X-API-Key | header | diperlukan | YOUR_SECRET_KEY |
logo | string | diperlukan | upload |
logoFile | file | diperlukan | PNG / JPEG / WebP · ≤ 2 MiB · ≤ 2048 × 2048 px · ≤ 4,000,000 px |
logoScale | integer | Pilihan | 12–30 · Perkataan default: 24 |
logoPadding | integer | Pilihan | 0–25% · Perkataan default: 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)Geometri QR di dalam SVG adalah berasaskan vektor. logo yang dimuat naik anda dimasukkan sebagai imej raster yang bersih, jadi butiran tidak menjadi tidak terhad. Untuk poster besar, periksa ketajaman logo secara berasingan.
Reka bentuk parameter
| parameter | Jenis | Keperluan | nilai-nilai |
|---|---|---|---|
X-API-Key / key | string | diperlukan | Kunci rahsia: tajuk atau parameter GET |
data | string | untuk teks dan url | Kandungan yang diperlukan untuk teks/url |
contentType | string | Pilihan | texturlwifivcardwhatsapptelegramphoneviberemailsmsPerkataan default: text |
format | string | Pilihan | pngsvgPerkataan default: png |
size | integer | Pilihan | 25651210242048Perkataan default: 1024 |
shape | string | Pilihan | squaresoftroundeddotsleaf-softleafhorizontalverticalpointednotchedstardiamondxx-roundedplusplus-roundedheartsparkleconfettiPerkataan default: square |
border | string | Pilihan | squarecircleroundedskewdrop-tldrop-brleafleaf-inner-brleaf-circleleaf-inner-tlsquare-circlesoft-tlsoft-brsoft-leafroughPerkataan default: square |
center | string | Pilihan | squarecircleroundedskewroughdrop-tldrop-brleafgearstardiamondxx-roundedplusplus-roundedheartPerkataan default: square |
foreground / eyeColor | string | Pilihan | #RRGGBB Perkataan default: #192b39 |
background | string | Pilihan | #RRGGBB Perkataan default: #ffffff |
level | string | Pilihan | LMQHPerkataan default: M |
quietZone | integer | Pilihan | 0 - 12 modul Perkataan default: 4 |
logo | string | Pilihan | noneuploadwhatsapplinklocationwificredentialemailscanbellmenuscan-mescan-me-v2paypalbitcoinsparkplusdiamondPerkataan default: none |
logoScale | integer | Pilihan | 12–30 Perkataan default: 24 |
logoPadding | integer | Pilihan | 0–25% Perkataan default: 5 |
logo=upload → POST / · logoFile · level=H
Jenis Kandungan
Untuk URL, berikan alamat https:// atau http:// lengkap. untuk nombor telefon, termasuk kod negara.
| contentType | Lapangan yang diperlukan | Lapangan Pilihan |
|---|---|---|
| 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=svgPenyelesaian api
Jawapan yang berjaya ialah fail imej itu sendiri, tanpa pengikat JSON. Jenis kandungan ialah imej/png atau imej/svg+xml. Kesilapan dikembalikan sebagai JSON:
{"error":"Invalid API key."}- 200 — imej yang dihasilkan.
- 401 — kekurangan atau kekurangan kunci.
- 405 — GET / POST
- 413 — Content-Length > 3 MiB
- 415 — POST: multipart/form-data
- 422 — parameter yang tidak sah atau kandungan yang hilang.
- 429 — Kadar yang melebihi; Retry-After: 60.
- 503 — Akses API tidak dikonfigurasi atau perlindungan sementara tidak tersedia.
- 500 — Kesilapan Generasi Dalam
Batas dan Validasi
Batas lalai ialah 60 permintaan per minit per IP. Kandungan yang disulitkan terhad kepada 800 byte. output PNG menyokong sehingga 2048 × 2048 px. SVG mengekalkan bentuk vektor.
API mengesahkan format parameter, saiz dan kontras, tetapi tidak menjalankan decoder atau memeriksa sama ada QR memindai.